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Preface 


Audience 


This manual provides reference material about the VAXmate workstation. It 
covers all programmable components, the firmware, and several MS-DOS re- 
lated environments, The material and its presentation are directed to expe- 


Manual Organization 


This manual is divided into four parts and appendixes: 
¢ Chapter 1 provides an overview of the VAXmate workstation and optional 
equipment. 

e Chapters 2 through 13 introduce the VAXmate workstation 
programmable hardware devices. Each chapter discusses a single hard- 
ware programming task, such as video input/output (I/O), external inter- 
rupt processing, or serial communications and includes the following 
information: 

- A brief device description 

- A list of additional references 

- A description of the programmable hardware registers 

- A programming example 

- A discussion of the example 

The examples are written in the C programming language to reduce the 
size of the examples and focus on the task rather than the detail required 
by the language. 

e Chapter 14 describes the power-up diagnostics and system startup. 


« Chapter 15 describes the read-only memory basic input/output system 
(ROM BIOS). 


e The appendixes contain additional information, including a bibliography of 
other useful publications, 
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Terminology 


The following terms are used throughout this manual and are defined as 
follows: 
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Term Definition 

Industry-standard The computer industry recognizes two open architectures 
as industry standards, the IBM PC AT bus structure and 
the Microsoft disk operating system (MS-DOS). Moreover, 
supporting MS-DOS requires a defined set of ROM BIOS 
services. The term industry-standard refers to compatibil- 
ity with these architectures. 


Reserved To avoid confusion and incompatibility, the use of certain 

Available items such as memory space, I/O space, interrupt vectors, 

Unassigned and ROM BIOS perameters or return values must be 
clearly defined. These three categories define those items 
that do not have a specific use. 


Reserved In future hardware or software releases, 
DIGITAL may define a specific use for this 
item. Hardware or software applications 
that use this item may not work with 
future releases. 


Available Hardware or software applications can use 
this item. DIGITAL has defined the spe- 
cific use of this item as available for 
applications. 

Unassigned | Hardware or software applications can use 
this item. However, there remains some 
risk that DIGITAL may define a specific 
use for this item. 
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Federal Communications Commission 
Radio Frequency Interference 


Class A Computing Devices 


This equipment generates, uses, and may emit radio frequency energy. The 
equipment has been tested and found to comply with the limits for a Class A 
computing device pursuant to Sub-part J of Part 15 of FCC Rules, which are 
designed to provide reasonable protection against such radio frequency interfer- 
ence when operated in a commercial environment. Operation of this equipment 
in a residential area may cause interference in which case the user at his own 
expense may be required to take measures to correct the interference. 


If this equipment does cause interference to radio or television reception, which 
can be determined by turning the equipment off and on, the user is encouraged 
to try to correct the interference by one or more of the following methods: 


* re-orient the receiving antenna 
e relocate the computer with respect to the receiver 
¢ move the computer away from the receiver 


e plug the computer into a different outlet so that computer and receiver 
are on different branch circuits. 


If necessary, the user should consult the dealer or an experienced radio 

and television technician for additional suggestions. The user may find the 
booklet, How to Identify and Resolve Radio/TV Interference Problems, 
prepared by the Federal Communications Commission helpful. This booklet is 
available from the U.S. Government Printing Office, Washington, DC 20402, 


Stock No. 004-000-00398-5. 


NOTE 

Shielded cables are provided for use with this device. Should any 
cables be replaced or added for any reason, these cables should 
be the same as, or with higher shielding capabilities, than those 
provided by Digital Equipment Corporation. 
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Chapter 1 
VAXmate Workstation Overview 


This chapter describes the VAXmate workstations physical appearance, base 
configuration, optional components, and the logical relationship of the 
components, 


The VAXmate workstation is a high-performance, standalone, desktop personal 
computer that executes industry-standard software. The integral Ethernet inter- 
face allows the VAXmate workstation to communicate on a network. The hard 
disk storage, provided in the optional expansion box, allows the VAXmate 
workstation to be a server on a network. 


Base System 
In the base configuration, the VAXmate workstation has three units: 
System unit 
¢ Keyboard 


e Mouse 


Figure 1-1 shows a base configuration workstation. 
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Figure 1-1 


ea aN 


cna 


ee ae 


Se 


LN ANN a 


Senna: 


Base Configuration Workstation 


HANSON 


ARRON 


In the base configuration, the system unit contains the following major 
components: 
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80286 microprocessor 


One megabyte of dynamic random-access memory (DRAM) 


Video monitor and controller 
Diskette drive and controller 
Ethernet controller 
Keyboard interface controller 
Event timer 

Real time clock and calendar 
Serial communications port 
Serial printer port 

Serial mouse port 

Speaker 

Power supply 
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Optional Components 


The workstation provides for the following optional components: 


e An expansion box, part number RCD31-EA, that attaches to the bottom 
of the system unit. Figure 1-2 shows the system unit with the expansion 
box attached. The expansion box contains an additional power supply, a 
battery, a 20 megabyte hard disk drive and controller, and two industry- 
standard expansion slots. 


¢ An 80287 coprocessor, part number FP287, that installs in the system 
unit. Figure 1-3 shows the 80287 coprocessor. 


* A two megabyte DRAM module, part number PC50X-AA, that installs in 
the system unit. Figure 1-4 shows the two megabyte DRAM module. 


* A modem module, part number PC50X-MA, that installs in the system 
unit. Figure 1-5 shows the modem module. 


Figure 1-2. Workstation With Installed Expansion Box 
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Figure 1-5 Optional Modem Module 
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Figure 1-6 shows the relationship of the workstation components. The battery 
is present only when an expansion box is installed. 
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Figure 1-6 Block Diagram of Workstation Components 
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Chapter 2 
VAXmate Microprocessor 


Overview 


The VAXmate microprocessor is an Intel 80286 central processing unit (CPU). 
The CPU is a high-performance, 8 MHz microprocessor with a 16-bit external 
data path and a 24-bit address path. The CPU provides two modes of opera- 
tion, real address mode and protected virtual address mode. 


Real Address Mode 


On powerup, the CPU operates in real address mode. In real address mode, the 
80286 CPU behaves as though it is a fast 8086 CPU. It is limited to the 1 
Mbyte address range of the 8086 CPU. In real address mode, the ROM is ac- 
cessed in the address range ODFOOOOH-OFFFFFH. 


Protected Virtual Address Mode 
In protected virtual address mode, the 80286 CPU can access 16 Mbytes of 


The ROM is redundantly mapped to two physical address ranges, OFOOQOQH- 
OFFFFFH and FFOOOOH-FFFFFFH. Therefore, in protected virtual address 
mode, the 80286 CPU can access the ROM at either physical address range. 
However, the majority of the ROM BIOS code is not valid in protected virtual 
address mode. 


The CPU uses the keyboard interface controller or a double exception fault to 
reset to real address mode from protected virtual address mode. The keyboard 
interface controller is discussed in Chapter 8. 
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Coprocessor 


The optional coprocessor for the VAXmate workstation is an Intel 80287 proc- 
essor extension chip. It is a high-performance, numeric processor that extends 
the CPU data types to include floating-point, extended-integer, and binary- 
coded decimal (BCD), 


Additional Sources of Information 


The following Intel Corporation documents provide additional information on 
the CPU and coprocessor: 


Introduction to the iAPX 286 (Publication Number 210308) 
iAPX 286 Hardware Reference Manual (Publication Number 210760) 
tAPX 286 Programmer’s Reference Manual (Publication Number 210498) 
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Memory Map 
The base configuration workstation has 1 Mbyte of RAM and 64 Kbytes of 
ROM. An optional memory module can be added without an expansion box. 


Table 2-1 describes the VAXmate workstation’s physical memory map. The 1 
Mbyte of RAM is divided into three, noncontiguous blocks. In Table 2-1, these 
blocks are labeled BLOCK1, BLOCK2, and BLOCKS. 


Table 2-1 Physical Memory Map 


From To Size Description 
(Bytes) 
000000H OO9FFFFH 640K System RAM (BLOCK1) 
Q0A0000H OAFFFFH 64K Reserved 
OBOOOOH OBFFFFH 64K Video RAM 


During video mode setup, the video 
RAM is dynamically mapped. Only 


the video RAM required by the cur- 
rent video mode is accessible. 


Cu” 0CO0000H OCFFFFH 64K Available for options with expansion 
ROM 


0DO0000H OEFFFFH 128K DIGITAL private RAM (BLOCK2) 
OFOOQO0H OFFFFFH 64K System ROM 

100000H EFFFFFH = 14336K Optional RAM space 

FOQOOOOH FILFFFFH 128K Reserved RAM space 

F20000H F5FFFFH 256K DIGITAL private RAM (BLOCK3) 
F60000H FIFFFFH 128K Reserved RAM space 

F80000H FEFFFFH 448K Reserved ROM space 


FFOOOOH FFFFFFH 64K System ROM (redundantly mapped 
from OFO000H) 
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Input/Output Address Map 


Table 2-2 describes the VAXmate workstation’s I/O address map. Many of the 
I/O ports have an industry-standard assignment. Recognition of that assign- 
ment does not indicate that the device is present in the workstation. 


Table 2-2 


From 
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8237A-5 
8259A 


0000H 
0020H 
0040H 
0060H 
0070H 
0070H 
0078H 
0080H 
00A0H 
00COH 
00K0H 
00FOH 
0OF1H 
00F2H 
00F8H 
0100H 
01FOH 
01F9H 
0200H 
0208H 
0278H 
0280H 
02F8H 
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Input/Output Address Map 
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To 


QOLFH 
003FH 
0O5FH 
O006FH 
0077H 
O0O7FH 
O009FH 
QOOBFH 
QODFH 
OOEFH 
OOF7H 
OOF FH 
OLE FH 
O1F8H 
O1FFH 
0207H 
O277H 
027FH 
OZ 7H 
O2FFH 


Device 


8254-2 
8042 
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MC146818 
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74LS670 


8259A 


Annona 


80287 


sissseaeyetisemnitsieemnte 


WD2010 


‘seein eee 


_snccepintcesctaeeonnesotenttt 


“irtoatsinaoetamRaPA 


8250 


VAXmate Microprocessor 


Description 


ie emirate enn apao enone meetin: 


DMA controller 
Interrupt controller #1 

Timer 

Keyboard interface controller 

Bit 7 controls the NMI mask register 
Real-time clock and CMOS RAM 
Reserved 

DMA page registers 

Interrupt controller #2 

Reserved 

Unassigned 

Clear math coprocessor busy 
Reset math coprocessor 
Unassigned 

Math coprocessor 

Unassigned 

Hard disk controller 

Unassigned 

Game port I/O 

Unassigned 

Parallel printer port #2 
Unassigned 


Serial port #2 (Integral modem option) 
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Input/Output Address Map (cont.) 
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From To Device Description 

0300H =«O31FH «Ss —___—siReserved SS a 

0320H O035FH eee Unassigned 

0360H O36FH ——— Reserved 

0370H 0377H -_—— Unassigned 

0378H 037FH —— Parallel printer port #1 

0380H 038FH cee Reserved 

0390H O39FH ———— Unassigned 

O3A0H 0O3AFH  —— Reserved 

03BOH 03BFH ——— Reserved 

03COH 03CFH  ——— Reserved 

03D0H O83DFH 6845 yraphics video controller 

03E0H 0O3EFH —— Unassigned 

O3FOH O3F5H PD765A Diskette controller 

O3F6H O3F7H ee Hard disk and diskette controllers 

03F8H O3FFH 8250 Serial port #1 

0400H OBFFH  ——— Unassigned * 

O0COOH 0OC1IFH —— System CSR 1 

0C20H OC3FH  —— Ethernet ROM 

0C40H OC5FH 2661 Universal Asynchronous Receiver/ 
Transmitter (UART) for mouse port 

OC60H OC7FH  —— Network Controller and Interface 

O0C80H Sa ————~ Special purpose register 

OC81H 0OC9FH —— Reserved 

OCAOH OCATH — 8250 Integral serial printer port 

OCA8H ODFFH Reserved 

QOEOOH FFFFH — mae Unassigned * 


iseinet 
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* Industry-standard, processor-board, I/O ports in the address range 0000H- 
OQOFFH respond to these I/O addresses. Therefore, I/O to the expansion 
box in this address range is undefined. 
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Interrupt Vector Map 
Table 2-3 shows the VAXmate workstation’s interrupts. The four columns in i 
Table 2-3 provide the following information: 
¢ The interrupt column identifies the interrupt number in hexadecimal. 
e The type column is interpreted as follows: 
- The letter # indicates a processor exception interrupt. 
- The letter H indicates a hardware interrupt. 
- The letter S indicates a software interrupt. 


- The letter P indicates that the interrupt vector space contains a 
pointer to a parameter table or an application routine. 


- The letter N indicates that the vector has no assignment. 


e The description column identifies the specific assignment of the interrupt 
vector. 


e The service column indicates whether or not the ROM BIOS services the 
interrupt. During system startup, interrupt vectors that are not serviced 
by the ROM BIOS are initialized to point to an interrupt return (IRET) 
instruction, indicated by IRET. For information on ROM BIOS-serviced 
software interrupts, see Chapter 15. 
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Table 2-3. Interrupt Vector Map 
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Interrupt Type Description Service 


00H E Divide by zero IRET 
O1H BE Single step IRET 
02H H NMI ROM BIOS 
03H S Breakpoint (Used by DEBUG) IRET 
04H E Overflow IRET 
05H S Print Screen function ROM BIOS 
06H-07H N Reserved IRET 
O8H H Timer interrupt service (IRQO) ROM BIOS 
09H H Keyboard interrupt service (IRQ1) ROM BIOS 
OAH H Reserved (IRQ2 interrupt from controller #2) [RET 


OBH H Serial port #2 (Asynchronous) (modem IRET 
option) (IRQ3} 


— OCH H Serial port #1 (Asynchronous) (IRQ4) ROM BIOS 
ODH H Unassigned (IRQ5) IRET 
QOEH H Diskette interrupt service (IRQ6) ROM BIOS 
OFH H Parallel printer port #1 (IRQ7) IRET 
10H S Video I/O ROM BIOS 
11H S Return configuration ROM BIOS 
12H S Return memory size ROM BIOS 
13H S Diskette and hard disk I/O ROM BIOS 
14H S Asynchronous communications I/O ROM BIOS 
15H 5 Extended ROM BIOS functions ROM BIOS 
16H S Keyboard I/O ROM BIOS 
lg Si S Printer Output ROM BIOS 


18H S Invoke network boot/Maintenance Operation ROM BIOS 
Protocol (MOP) 


19H S Bootstrap ROM BIOS 
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1AH 
ped | 
1CH 
1DH 


20H-3FH 
40H 
41H 
42H-45H 
46H 
47H-5FH 
60H-67H 


68H-6FH 
70H 
71H 


IZ 

73H 

74H 

75H 

76H 

77H 
78H-7FH 
80H-FOH 
FLH-FFH 
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Time of day 

Keyboard BREAK vector 
Timer tick vector 

Video parameter table 
Diskette parameter table 


Graphics character table (Character codes 
80H-FFH) 


Reserved for MS-DOS 

INT 13H redirect when hard disk in use 
Parameter table pointer for hard disk 0 

Reserved 

Parameter table pointer for hard disk 1 

Reserved 


Available for application or user program 
interrupts 


Reserved for DECnet software 
Real time clock interrupt (IRQ8) 


Redirect to interrupt OAH - Old IRQ2 
(IRQ9) 


Ethernet controller (IRQ10) 
Serial printer port (IRQ11) 
Mouse port (IRQ12) 

80287 error (IRQ13) 

Hard disk controller (IRQ14) 
Unassigned (IRQ15) 
Unassigned 


Reserved 
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ROM BIOS 
IRET 
IRET 
ROM BIOS 
ROM BIOS 
ROM BIOS 


IRET 
ROM BIOS 
ROM BIOS 
IRET 
ROM BIOS 
IRET 
IRET 


IRET 
ROM BIOS 
IRET 


ROM BIOS 
ROM BIOS 
IRET 
ROM BIOS 
ROM BIOS 
IRET 
IRET 
IRET 
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Bus Timing and Structure 


The 8 MHz clock rate results in a 125 ns processor cycle. Normal operation of 
the 80286 CPU requires two processor cycles. With zero wait states, a read or 
write cycle requires 250 ns. 


There are three data bus structures: 


¢ A 16-bit local bus 
An 8-bit expansion bus 
A 16-bit expansion bus 


16-Bit Local Bus 


The local bus connects the CPU to on-board memory and on-board peripherals. 
One wait state is added to local bus memory transfers, resulting in a 375 ns 
bus cycle. Two wait states are added to local bus input/output (I/O) transfers, 
resulting in a 500 ns bus cycle. 


The RAM access time is 150 ns. The ROM access time is 250 ns. 


NOTE 

tiguous I/O instructions at the same device may not provide 
enough time for the device to respond. This is possible because 
peripheral devices respond more slowly than the 80286 proces- 
sor executes. A jump instruction consumes processor cycles and 
clears the processor pre-fetch queue. Thus, jumps to successive 
[/O instructions provide the required response time. The C lan- 
guage I/O functions, commonly named in() and out() or inp() and 
outs(), provide enough response time because they contain suf- 
ficient overhead in the calling sequence. 


16-Bit Expansion Bus 


The 16-bit expansion bus supports word transfers to memory and I/O. One wait 
state is automatically added, resulting in a 375 ns bus cycle. 


8-Bit Expansion Bus 


The 8-bit expansion bus supports byte and word transfers to memory and I/O. 
Word transfers are controlled by hardware, which issues two sequential byte 
transfers (low byte first and high byte second). Table 2-4 describes the bus 
cycle times for all transfer types on the 8-bit expansion bus. 
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Table 2-4 8-Bit Expansion Bus Transfer Times 
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Type 


Memory 


Memory 
I/O 
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Size 
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Byte 
Word (two, 8-bit transfers) 1500 ns 
1125 ns 


2250 ns 


Byte 


Oe 
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Wait States 
4 
8 
7 


14 


opener 


1/O Word (two, 8-bit transfers) 
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Expansion Box Technical Specifications 


The VAXmate expansion box provides two expansion module slots. Each slot 
accommodates a single expansion module. If a mother-daughter board is used 
in one of the slots. then both slot areas will be used and it will not be possible 
to add a second module. Table 2-5 shows the amperage (current) and wattage 
values available for each slot. Each slot has an 8-bit and a 16-bit bus connector. 
Figure 2-1 shows the pin numbers and signal names for the 8-bit and 16-bit 
bus connector. 


Table 2-5 Expansion Slot Power Ratings 


Slot +5.1V +12.1V -12.0V -5.0V Watts 


0.100 0.100 9.540 
0.100 0.100 9.540 
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0.100 
0.100 


OPT-1 1.300 
OPT-2 1.300 
Expansion Box Operating Ranges 
Ambient Operating Temperature: 15 C (59 F) to 32 C (90 F) 
Relative Humidity: 8% to 80% 
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8-Bit Bus Connector 


GROUND 
RESET H 
+5V 
IRQS H 
—5V 
DRQ2 H 
—~12V 
OWS L 
+12V 
GROUND 
MEMW L 
MEMR L 
IoW L 
TOR L 
DACK3 L 
DRQ3 H 
DACK] L 
DRQ] H 


REFRESH L | 


CLOCK H 
IRQ? H 
TRQ6 H 
IRQ5 H 
IRQ4 H 
TRQ3 H 
DACK2 L 
T/C 
ALE H 
+5V 
OSC H 
GROUND 


| B: | 1/0 
|B2  <A2 | SD7 
|1B3 A3_ | ~SD6 
IB4 A4 | SD5 
|B5 AS | SD4 
|1B6 A6 | SD3 
B7 = A7 {| SD2 
BB =A8 | SDI 
|B9 A9 | SDO 

1 | 1/0 


B20 A20| SA11 
By A21| SA10 
{B22 A22| SA9 
{B23 A23| SA8 
| SA7 
[B25 A25| SA6 
B26 A26| SA5 


SA3 
| SA2 
B30 A30| SA1 

a0 
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16-Bit Bus Connector 


DRO6 H 
DACK7 L 
DRQ7 H 
+5V 
MASTER L 
GROUND 


| UA19 
| UA18 


| SD14 


SBHE 
VA23 
UA22 
UA21 
UA20 


Samm ames 


UA17 
EMEMR L 
EMEMW L 
SDO8 
SDO9 
SD10 
SD11 
SD12 
SD13 


x= ara Em Se 


SD15 


*k Not Implemented 


Figure 2-1 8-Bit and 16-Bit Bus Connectors 
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Chapter 3 
Interrupt Controllers 


Overview 


The VAXmate 80286 central processing unit (CPU) has two interrupt input 
lines, the Non-Maskable Interrupt (NMI) and the Interrupt Request (INTR). 
When these hardware inputs are active, the CPU suspends execution of the 
handler is a program or program segment that responds to a specific event. 
This allows an immediate response to asynchronous external events and the 
segregation of program responsibility for handling those events. 


The interrupt input lines are assigned to different classes of events. The NMI 
is dedicated to two catastrophic events, memory parity errors and I/O bus 
errors. The INTR is assigned all other external interrupt sources, such as 
diskette and hard disk controllers, serial and parallel ports, and clocks. The 


“ 


reason for this division is the way the CPU implements the two interrupts: 


¢ The NMI has a higher priority than the INTR. 
¢ The CPU has no way to disable the NMI input. 


* The CPU provides handshaking protocol during INTR processing, but not 
during NMI processing. 


« The NMI generates only one interrupt vector, which is fixed. 
Because the CPU does not provide handshaking during NMI processing. the 
sources are connected directly to the NMI input. To determine the source of 


the interrupt, the NMI interrupt handler must read the status output of the 
sources. 
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The INTR input is buffered by two, 8259A interrupt controllers. The interrupt 
controllers reduce the CPU interrupt processing overhead in the following 
ways: 


They resolve the priority of simultaneous or overlapping interrupts. 
* They concentrate multiple interrupts into one source. 
e They provide the vector number of the interrupt handler. 


Each interrupt controller is capable of handling eight interrupt requests. The 
16 inputs are labeled IRQO-IRQ15. Controller 1 buffers IRQO-IRQ7 and control- 
ler 2 buffers IRQ8-IRQ15. Although they are physically identical, the interrupt 
controllers have a master/slave relationship. The output of controller 2 (the 
slave) is connected to the IRQ2 input of controller 1 (the master). The output 
of the master is connected to the INTR input of the CPU. Table 3-1 shows all 
of the IRQ inputs. 


Table 3-1 Interrupt Request Lines 
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Priority Controller Controller Source 
#1 MASTER #2 SLAVE 
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1 IRQO Event timer output 0 
2 IRQ1 Keyboard controller 
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3 IRQ2 Slave interrupt controller 
Oud IRQ8 Real-time clock 
3.2 IRQ9 Software redirection to IRQ2 
a IRQ1L0 LANCE (Ethernet) 
3.4 IRQI1 Serial printer port 
3.5 IRQ12 Mouse port 
3.6 IRQ13 Coprocessor error 
= ae IRQ14 Hard disk drive controller 
3.8 IRQ15 Available, 16-bit bus 
4 IRQ3 Reserved, integral modem option 
IRQ4 Asynchronous communications port 
6 IRQ5 Available, 8-bit bus 
7 IRQ6 Diskette drive controller 
8 IRQ7 Available, 8-bit bus 
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a- 2 Interrupt Controllers - Hardware Description 


Additional Source of Information 


The following Intel Corporation document provides additional information: 


¢ Microsystem Components Handbook (Publication Number 230843) 


Read/Write Control 


The 8259A interrupt controller has the following registers: 


Initialization Command Words (ICW) - There are four initialization com- 
mand words (ICW1-ICW4). They establish the operating conditions of the 
interrupt controller and are written only during system initialization. 


Operation Command Words (OCW) - There are three operational command 
words (OCW1-OCW3). These registers select access to internal controller 
registers and control the run-time aspects of the interrupt controller, 


Interrupt Mask Register (IMR) - The IMR selectively enables and disables 
the interrupt controller's interrupt input lines. In this manual, IMR refers to 
the physical register and OCW1 refers to the command to read or write the 
interrupt mask register. 


Interrupt Request Register (IRR) - Following a CPU interrupt acknowledge, 
each bit in the IRR reflects the state of the corresponding interrupt input. 


In-Service Register (ISR) - The ISR register indicates the interrupt input 
lines that the CPU is currently servicing. 

Poll data - The poll data indicates whether any enabled interrupt inputs are 
active. If any enabled interrupt inputs are active, it also contains the inter- 
rupt input number of the highest priority input requesting service. 


Although the 8259A interrupt controller has many registers, it has only two 
input/output (I/O) ports. Table 3-2 shows the master and slave I/O port ad- 
dresses. Table 3-3 shows the registers and the requirements to access them. 


Table 3-2. Master and Slave I/O Addresses 
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Port Master Slave 
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0 0020H OOAOH 
i 0021H QOALH 
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Table 3-3 Accessing the Interrupt Controller Registers 
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Register R/W_ Port Access Method 
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ICW1 Ww 0 When bit 4 of the value written to port 0 equals 1, 
ICW1 is selected. 


ICW2 W 1 Must be the next byte written after ICW1. 


ICW3 WwW | The interrupt controller expects [CW3 only if ICW1, 
bit 1 equals 1. If written, ICW3 must be the next 
byte written after [CW2. 


ICW4 WwW 1 The interrupt controller expects ICW4 only if ICW1, 
bit O equals 1. If [CW4 is written and ICW3 is not, 
ICW4 must be the next byte written after [CW2. If 
ICW3 and ICW4 are written, ICW4 must be the 
next byte written after [CW3. 


OCW! R/W 1 Reading or writing OCW1 requires only that the in- 
itialization process be complete. Reading or writing 
OCW1 accesses the interrupt mask register. 

OCW2 WwW 0 Writing OCW2 requires that the initialization proc- 
ess be complete and OCW2 bits 4-3 are equal to 0. 

OCW3 WwW 0 Writing OCW3 requires that the initialization proc- 
ess be complete, OCW3 bit 4 equals 0, and OCW3 
bit 3 equals 1. 
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IRR R 0 Reading the IRR is a two-step process. First, issue 
the read IRR command (write OCW3 with OCW3 
bit 1 equals 1 and OCW3 bit 0 equals 0). Then, read 
the IRR through port 0. Until another command is 
written to OCW38, subsequent reads of port 0 return 
the IRR. 


ISR R 0 Reading the ISR is a two-step process. First. issue 
the read ISR command (write OCW3 with OCW3 
bit 1 equals 1 and OCW3 bit 0 equals 1). Then, read 
the ISR through port 0. Until another command is 
written to OCW3, subsequent reads of port 0 return 
the ISR. 


Poll Data R 0) Reading the poll data is a two-step process. First, 
issue the read poll data command {write OCW3 with 


OCW3 bit 2 equals 1). Then, read the poll data 
through port 0. The OCW3 poll command must 
always be written prior to reading the poll data. 
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Initialization Command Words 


The 8259A interrupt controllers do not have a hardware reset. After power is 
applied to the system and until they are initialized, the interrupt controllers are 
in an undefined state. The VAXmate startup code initializes the interrupt 
controllers. 


Initializing the 8259A interrupt controller requires from two to four initializa- 
tion command words written in sequence. 


The interrupt controller recognizes ICW1 as the start of an initialization se- 
quence. An ICW1 resets the interrupt controller as follows: 


circuit is reset. After initialization, an interrupt request input must make 
a low-to-high transition to generate an interrupt. 


2. All bits in the IMR are cleared (enabled). Because the initialization se- 
quence enables interrupt inputs, on completion of the initialization se- 


quence, the interrupt controllers can immediately issue interrupt 
requests. Therefore, the interrupt vectors and handlers should be in- 
itialized prior to initializing the interrupt controllers. 


3. The IRQ7 input is assigned priority 7. 
p g p y 
4, The slave mode address is set to 7. 


5. If ICW1 bit 0 equals 0, all bits in ICW4 are cleared (0). 


status read bits are set to read the IRR. 


7. The interrupt controller enters fully nested mode. All other modes of op- 
eration are variations of this mode. In fully nested mode, the interrupt 
inputs have a fixed order of decreasing priority and the priority of an 
input corresponds to its input number 0 (highest) - 7 (lowest). While the 
CPU is servicing an interrupt (until the interrupt controller receives an 
end-of-interrupt command), the controller inhibits interrupts of equal or 
lower priority. However, the current interrupt service can be nested in 
favor of a higher priority interrupt as follows: 


- The higher priority interrupt input must be unmasked (enabled). 
- The CPU INTR input must be enabled (STI instruction). 


NOTE 

The 8259A interrupt controller is compatible with two 
microprocessor families, 8080/8085 and 8088/8086/80286. 
Because the VAXmate CPU is an 80286, this manual describes 
only the 80286 application. Those bits dedicated to the 8080/ 
8085 family are unused and described only as belonging to the 
8080/8085 family, 
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The 8259A interrupt controller has the following mutually exclusive methods of 
indicating whether an interrupt controller is a master or a slave: 


¢ The initialization sequence selects nonbuffered mode in 
ICW4., In nonbuffered mode, a hardware connection to the 
SP/EN pin determines whether the controller is a master 
or a Slave. In this mode, a high level at the SP/EN pin 
indicates a master and a low level at the SP/EN pin indi- 
cates a slave. The VAXmate workstation uses this method. 


¢ The initialization sequence selects a buffered master or a 
buffered slave in ICW4, 
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Initialization Command Word 1 (0020H/00A0H) 
7 6 5 4 3 2 1 0 


Bit R/W_ Description 
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7-5 W Always 0 (These bits are used only by the 8080/8085 CPU family.) 


4 Ww Always 1 
For values written to port 0, this bit distinguishes an ICW1 from 
operational command words 2 and 3. For additional information, 
see Table 3-3. 


3 W TRIGGER MODE 
0 = Edge-triggered mode 
1 =  Level-triggered mode 


For either trigger mode, a low-to-high transition at an interrupt 
input generates an interrupt request. In edge-triggered mode, to 
generate another interrupt request at the same input, the input 
must change from high to low and back to high. In level-triggered 
mode, while that interrupt input remains high, the controller can 
generate additional interrupt requests for that input. The 
VAXmate startup code initializes the interrupt controllers to edge- 
triggered mode. 


2 Ww Always 0 (This bit is used only by the 8080/8085 CPU family.) 


1 WwW SINGLE/CASCADE 
Q = Cascade mode 
1 = Single mode 


Single mode indicates that this is the only interrupt controller in 
the system. Therefore, it is neither a master nor a slave and ICW3 
is not written. Cascade mode indicates that there is more than one 
interrupt controller in the system. Therefore, it is either a master 
or a slave and ICW3 is required. The VAXmate workstation uses 
cascade mode. 


0 W ICW4 REQUEST 
0 = I[CW4 is not required 
1 = ICW4 is required 
This bit indicates whether ICW4 is required in the initialization se- 
quence. The VAXmate workstation requires IC W4. 
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For the master ICW1 and the slave [CW1, use 11H. 
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Initialization Command Word 2 (0021H/00A1H) 
7 6 5 4 3 2 1 4) 


netic 


Bit R/W_ Description 


7-35 OW Bits 7-3 of the interrupt number for interrupt input 0. 


This value corresponds to the address of the interrupt vector di- 
vided by four. The interrupt controller generates a sequential inter- 
rupt number for each of the interrupt inputs by ORing the 
interrupt input number and [CW2. Because the interrupt input 
number is ORed to the value in ICW2, there is no carry involved. 
Therefore, the value in ICW2 must be evenly divisible by 8 
(modulo 8). 


2-0 W Always 0 
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For the master ICW2, use 08H. For the slave ICW2, use 70H. 
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Initialization Command Word 3 (0021 H/00A1H) 


When there are two or more interrupt controllers in the system, an ICW38 is 
used in the initialization sequence. The VAXmate workstation has two interrupt 
controllers and requires ICW3. The meaning and use of ICW3 depends on 
whether the interrupt controller is a master or a slave. 


ICW3 (Master) 


Bit R/W_ Description 


7-0 W For each master interrupt input that is connected to a slave, the 
corresponding ICW3 bit is set (1). The master interrupt controller 
can then determine which interrupt inputs require a slave identifi- 
cation on the cascade lines. For the master ICW3, use 04H. 


ICW3 (Slave) 
7 6 S. 4 2 2 i 0 
os Fil al 5 ie ar cen 


SLAVE ID 


Bit R/W_ Description 
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7-30 W Always 0 
2-0 W SLAVE ID - Slave Identification 
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The slave identification is the master interrupt input (7-0) to which 
the slave is connected. During the CPU interrupt acknowledge se- 
quence, the slave compares its cascade input to these bits. If they 
are equal, the slave places the interrupt vector number on the I/O 
data bus. For the slave ICW3, use 02H. 
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Initialization Command Word 4 (0021H/00A1H) 
i 6 5 4 = 2 1 O 
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SPECIAL 
FULLY | MASTER/ EOI 


| SLAVE MODE 


CPU 
MODE 
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Bit R/W pee pugd 
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7-5 WwW Aways 0 


4 Ww SPECIAL-FULLY-NESTED MODE * 
Q = Disable special-fully-nested mode 
1 = Enable special-fully-nested mode 


3-2 W BUFFERED MODE and MASTER/SLAVE 

OX = Nonbuffered mode - In nonbuffered mode, a hardware con- 
nection to the SP/EN pin determines whether the control- 
ler is a master or a slave and bit 2, the master/slave 
selection, has no effect. In this mode, a high level at the 
SP/EN pin indicates a master and a low level at the SP/ 
EN pin indicates a slave. The VAXmate workstation uses 
this mode. 

10 = Buffered mode slave - The VAXmate workstation is incapa- 
ble of operating in this mode. 

11 = Buffered mode master - The VAXmate workstation is inca- 
pable of operating in this mode. 


i Ww EOI MODE - End-of-interrupt Mode 

0 = Normal EOI - In this mode, the CPU must write an EOI 
command to the interrupt controller. The VAXmate startup 
code initializes the interrupt controller to normal EOI mode. 
The EOI command is explained in the operation command 
word 2 description. 

1 = Automatic EOI - In automatic EOI mode, the interrupt con- 
troller generates its own EOI on the second acknowledge 
pulse. 


0 Ww CPU MODE 
0 = 8080/8085 microprocessor family 
1 = 8088/8086/80286 microprocessor family 


The VAXmate workstation uses the 80286 CPU mode. 


* Special- filly: nested mode is for master mtervapt controllers. For the 
master interrupt controller, each slave controller is a single interrupt 
input, Thus, the master controller cannot resolve the priority of the slave 
controller interrupt inputs. If a slave controller has an active. low prior- 
ity interrupt that is nested in favor of a higher priority interrupt, the 
master inhibits the new slave interrupt request. This effectively disables 
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Sc 


nesting of slave interrupts. In special-fully-nested mode, the master inter- 
rupt controller acts on all slave interrupt requests, which allows the slave 
to nest interrupts. The VAXmate workstation startup code disables the 
special-fully-nested mode. 


For the master IC W4 and the slave ICW4, use O1H. 


Operation Command Words 


The interrupt controller provides three operation command words (1-3) that are 
programmed after the initialization sequence is complete. The operation com- 
mand words select various modes or operations as follows: 


Read or write the interrupt mask register 

Accept specific or nonspecific end-of-interrupt commands 
Enable or disable various automatic priority rotation schemes 
Set a specific priority level 

Set or reset the special mask 

Read poll data 

Read the interrupt request register 

Read the in-service register 


Operation Command Word 1 (0021H/00A1H) 
7 6 5 4 e 2 1 0 


* @® @ @ @ @ @ @ 


MASK BITS 


Bit R/W_ Description 
7-0  R/W_ Interrupt mask register bits 
0 = Corresponding interrupt inputs are unmasked (enabled) 


1 = Corresponding interrupt inputs are masked (disabled) 
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OCW1 reads or writes the interrupt mask register (IMR). Each bit in the IMR 
enables or disables the corresponding interrupt input. 
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Operation Command Word 2 (0020H/00A0H) 


7 6 5 4 3 2 1 0 


INTERRUPT LEVEL 


ROTATE 
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7-5 W ROTATE ISLIE Ol 
000 = Disable rotation in automatic EOI mode 
001 = Nonspecific end-of-interrupt (EOI) 
010 = No operation 
011 = Specific end-of-interrupt 
100 = Enable priority rotation in automatic EOI mode 
101 = Rotate priority on nonspecific EOI 
110 = Rotate priority to specific interrupt input 
111 = Rotate priority on specific EOI 
4 WwW Always 0 


For values written to port 0. this bit distinguishes operational com- 
mand words 2 and 3 from an ICW1. See Table 3-3. 


3 Ww Always 0 
This bit distinguishes OCW2 from OCW3. See Table 3-3. 

2-0 W INTERRUPT LEVEL 
For interrupt-specific operations, these bits contain the interrupt 
input number (0-7) to act on. For nonspecific operations, these bits 
are ignored. 
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OCW2 issues an end-of-interrupt command or sets a priority rotation mode. 
Some OCW2 operations are nonspecific. (They act on the interrupt input that 
has the highest priority, whichever one that may be.) Non-specific commands 
do not use INTERRUPT LEVEL (OCW2 bits 2-0). Specific OCW2 operations 
require the interrupt input. number (0-7) in INTERRUPT LEVEL. 


For the master OCW2 and the slave OCW2, use 20H (nonspecific EOI 
command). 
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Priority Rotation 


In nonspecific or automatic EOI mode, priority rotation has the effect of 
assigning equal priorities to all interrupt inputs. On receipt of an EOI com- 
mand, the interrupt controller assumes that the active interrupt input with the 
highest priority is the interrupt just completed. The priority bits are rotated 
until the just completed interrupt has the lowest priority (7). If that interrupt 
input requires further service, it must wait until it is again the highest priority 
interrupt or until all interrupts of higher priority are inactive. 


In Figure 3-1, interrupt inputs 2, 5, and 6 are requesting service and interrupt 
input 2 has a higher priority than interrupt inputs 5 and 6. After interrupt 
input 2 is serviced, the interrupt controller rotates the priority as shown in 
Figure 3-2. In Figure 3-2, interrupt input 3 has the highest priority, but it is 
inactive. Because interrupt input 5 has the highest priority of the active inter- 
rupts, it is the next interrupt input serviced. 


Rotating priorities to a specific interrupt input is another method of priority 
rotation. In this method, the lowest priority is set, thereby fixing all other 
priorities. For example, if interrupt input 2 is programmed as the lowest prior- 
ity, then interrupt input 3 becomes the highest. OCW2 bits 2-0 define the in- 
terrupt input number that is assigned the lowest priority. This method is not 
used in the VAXmate workstation startup code. 
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In-Service Bits 
7 6 5 4 3 Z 1 0 
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Priority Status 


5 
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Figure 3-1 Priority Before Rotation 
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Figure 3-2. Priority After Rotation 
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Operation Command Word 3 (0020H/00A0H) 


7 6 5 4 3 2 L 0 
ENABLE | SPECIAL 
SPECIAL | MASK POLL 
MASK MODE 
MODE 0) 1 
Bit R/W_ Description 


7 WwW Always 0 


6-5 W ENABLE SPECIAL MASK MODE/SPECIAL MASK MODE 
00 = No action 
01 = #£xNo action 

10 Disable special mask mode 

11 = Enable special mask mode 


II 


Some operations require that an interrupt service routine dynami- 
cally change the priority structure. Masking an interrupt input in 
the special mask inhibits that priority level and enables all other 
priority levels (lower and higher) that are unmasked. After enabling 
special mask mode, the special mask is read or written to the 

IMR. 


4 WwW Always 0 
For values written to port 0, this bit distinguishes operational com- 
mand words 2 and 3 from an ICW1. See Table 3-3. 


3 WwW Always 1 
This bit distinguishes OCW3 from OCW2. See Table 3-3. 


2-0 W POLL/READ IR REG/READ IS REG 
000 = No action 
001 No action 
O10 Read the IRR. * 
011 = Read the ISR. * 
100 = Read the poll data. ** 
101 = Read the poll data. ** 
110 = Read the poll data. ** 
111 = Read the poll data. ** 

* See Table 3-3 aud the IRR/ISR dees ription. 

** See Table 3-3 and the poll command description. 
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For standard operation of the VAXmate workstation, neither the master nor 
the slave use OCW3., 
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Interrupt Request and In-Service Registers 


Interrupt Request Register 


7 6 5 4 3 2 1 0 


tain the state of the interrupt controller. During the first interrupt acknowledge 
of the CPU interrupt acknowledge sequence, the IRR latches the state of the 
interrupt input lines. The internal output of the Interrupt Mask Register (IMR) 
gates the output of the IRR to the priority encoder. Assuming that one or 
more IRR bits are set (active) and unmasked (enabled), the priority encoder de- 
termines which one has the highest priority. During the second interrupt ac- 
knowledge, that IRR bit is strobed into the corresponding ISR bit, the edge 
sense circuitry for that interrupt input is reset, and the interrupt vector 
number is placed on the I/O data bus. 


Because the interrupt controller can nest interrupts, the ISR can contain one, 
two, or more bits that are set. This shows that another interrupt was acknowl- 
edged before other interrupt processing was completed. A specific end-of- 
interrupt (EOI) clears the indicated ISR bit. A nonspecific EOI clears the 
highest-priority ISR bit. 


If an IRR bit is set (active) and masked (disabled), unmasking (enabling) that 
active IRR bit creates an interrupt. 
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Poll Command 


When issued, the poll command performs steps similar to those described in 
the IRR/ISR description. The poll command replaces the function of the CPU 
interrupt acknowledge sequence. Instead of placing the interrupt vector number 
on the I/O data bus, the poll command connects the output of the poll data 
register to the port 0 output buffer. The polling interrupt handler then reads 
the poll data to determine if an interrupt input is active and, if so, which one. 
To complete the interrupt sequence, the polling interrupt handler must issue an 
EOL. 


Poll Data Register 
7 6 2 4 2 2 1 0 
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INTERRUPT INPUT 
NUMBER 
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Bit Description 
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Neca 7 R INT ACTIVE FLAG - Interrupt active flag 

0 = No active interrupt inputs 
1 = At least one interrupt input is active 

6-3 R Always 0 

2-0 R INTERRUPT INPUT NUMBER 
If bit 7 equals 1. these bits contain the interrupt input number (0- 
7) of the highest priority interrupt input that is active. If bit 7 
equals 0, these bits have no meaning. 
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Interrupt Sequence 


The following list describes interrupt processing. Each item in the list describes 
a system state or event. After a discussion of the state or event, the descrip- 
tion indicates the next state or event. For the following interrupt processing 
description, it is assumed that the interrupt controllers are initialized as pre- 
viously described. Later, Figure 3-3 shows the same logic in the form of a flow 
chart. 


=~] 


Until one or more interrupt controller input lines become active, the con- 
troller is idle. If one or more inputs are active, go to 2. 


If any of the newly active inputs are unmasked (enabled), go to 4. 
Otherwise, go to 3. 


If other interrupt inputs are pending, go to 5. Otherwise, go to 1. 
If no other interrupt inputs are pending, go to 7. Otherwise, go to 6. 


If the controller is waiting for an end-of-interrupt command, go to 6. 
Otherwise, go to 7. 


If any interrupt has a priority higher than the one being processed by 
the CPU, nest the interrupts and go to 7. Otherwise, go to 8. 


The controller activates its interrupt output line and waits for an ac- 
knowledge signal from the CPU. 


If the interrupt controller input is a slave input, then the slave interrupt 
output line activates the master interrupt controller IRQ2 interrupt 
input. The master interrupt process starts at step 2. Eventually, the 
master IRQ2 input becomes the highest priority master interrupt that is 
active and the master controller arrives at this step. At that time, both 
controllers are waiting for the CPU acknowledge signal. 


In either case, the master interrupt controller activates its interrupt 
output line, which triggers an external latch. The external latch drives 
the CPU INTR input. 


NOTE 

This external latch, between the master interrupt controller in- 
terrupt output and the CPU INTR input, was incorporated due 
to an advisory on an 80286 CPU design flaw. 


Disabling the CPU INTR input before disabling an interrupt 
controller input or initializing the interrupt controllers can leave 
the latch set. On reenabling the CPU INTR input, the latch 
could indicate an interrupt request when none exists. 


To avoid this situation, disable the interrupt controller input or 
write the first master interrupt controller initialization command 
before disabling the CPU INTR input. 


3-18 Interrupt Controllers - Hardware Description 


If the CPU INTR input is disabled, the interrupt controller continues to 
wait. If other interrupt controller inputs become active during this waiting 
period, go to 2. When the CPU INTR input is enabled, the CPU recog- 
nizes the interrupt request and responds with an acknowledge signal. 


On receiving the acknowledge, the interrupt controller sets the highest 
priority bit in the in-service register and resets the corresponding bit in 
the interrupt request register. This allows the controller to recognize an- 
other ihn request at that anauheas controller input. 


sone llek recognizes athe seagnd praia pies it ee 
whether the interrupt input source is a slave interrupt controller. If the 
interrupt input source is not a slave, the master controller places a 
preprogrammed 8-bit interrupt vector on the input/output (I/O) data bus. 
If the interrupt input source is a slave, the master controller places the 
slave address (master interrupt input number 0-7) on the cascade lines. 
When enabled by the slave address on the cascade lines, the slave places 
the preprogrammed 8-bit interrupt vector on the input/output (I/O) Pee 
bus. In either case, the CPU reads the 8-bit interrupt vector, stacks the 
current state and begins executing the interrupt handler that is pointed 
to by the contents of the interrupt vector. 


The interrupt controller(s) are waiting for an end-of-interrupt (EOI) com- 
mand. When a slave interrupt is processed, an EOI command is required 
by both the slave and the master. 


If an interrupt occurs during this waiting period, go to step 2. When the 
CPU writes the end-of-interrupt command, go to step 1. 
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Figure 3-3 Interrupt Sequence 
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Programming Example 


The following programming examples demonstrate: 


e Initializing a master or slave 8259A peripheral interrupt controller (PIC) 


¢ Programming the PIC interrupt mask register 
¢ Issuing end-of-interrupt commands to a master or slave PIC 


The example provides routines as described in the following: 


pic_init Initializes the master and slave PICs. 
imask Masks or unmasks the specified bit in the interrupt mask 
register. 
eoi Issues an end-of-interrupt command to the appropriate PICs. 
CAUTION 


Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual, No other use is intended. 
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Constant Values and Data Structures 


¥ 


The constant value NPIC defines the number of peripheral interrupt controllers 
in the VAXmate workstation. 


The constant value HOT defines the bit value that must be issued to OCW2 to 
establish an end-of-interrupt condition. 


The structure type PIC defines the input/output ports of the 8259A peripheral 
interrupt controller (PIC). These two ports access the PIC registers. The bit 


cessed register. 

The structure type P/JC DAT detines the type of data required to initialize a 
Pic. 

Initialization Data 


The array of structures al/pics provides the actual data for initializing the 
master and slave PICs. Later, references to the PIC number refer to the posi- 
tion of an element in the array allpics. 
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/* define constants and structures used in 8259 PIC example + f 


#define NPIC 2 /* number of pics in system */ 
#define EOI 0x20 /* bit value of EOI command */ 
typedef struct /*x define pic I/0 structure */ 
: 
unsigned char port0O; /* when address line AO = 0 */ 
unsigned char porti; /* when address line AO = 1 */ 
} PIC; 


typedef struct 


{ 
PIC *base; /* base I/0 address of pic */ 
char icw2; /* modulo 8 base int vector */ 
char icw3; /* ir has a slave or slave id */ 
char icw4; /* icw4 mode data */ 


} PIC_DAT; 


/* define pic initialization data * | 


PIC_DAT allpics[NPIC] = /* device data tables */ 
{ 
{ (PIC *)0x0020, 0x08, 0x04, Ox01 }, /* pic 0 is the master */ 
{ (PIC *)0x00a0, 0x70, 0x02, Ox01 }, /* pic 1 is the slave */ 
ie 
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Initializing the Peripheral Interrupt Controller 


The function pic_init initializes the master and slave PICs. Because the ROM 
BIOS startup sequence initializes the peripheral interrupt controllers (PIC), in- 
itialization of the PICs is not normally required. 


Because the initialization sequence clears the interrupt mask register. the CPU 
interrupt flag is cleared after the initialization is started and before the initiali- 
zation is complete. Thus, no interrupts are pending when the initialization is 
started and the CPU will not respond to any interrupts that become active 
during the initialization sequence. 


The first two instructions write a value to port 0 of the indicated PIC. The 
value of bit 4 is key to this operation. Writing a value to port 0, with bit 4 set, 
selects the ICW1 register and indicates a reset sequence. The PIC stores the 
remaining ICW1 bits in the ICW1 register, which starts the initialization 
sequence. 


e Bit 0 is set, indicating that the initialization sequence includes ICW4. 


e Bit 1 is clear, indicating that the addressed PIC is involved in a cascade 
(master/slave) arrangement and that I[CW3 must be written during the in- 
itialization sequence. That is, the PIC is not operating in a standalone 
environment. 


e Bit 3 is clear, indicating that the PIC is operating in edge-triggered mode. 


e All other [CW1 bits apply to the 8085 mode of operation and are not 
used, 


Because two PICs must be initialized. the rest of the initialization sequence is 
performed within a for loop as follows: 


1. The first instruction initializes a pointer to the required data. 
2. The second instruction initializes a pointer to the port 0 I/O address. 


3. The third instruction writes the base interrupt vector to port 1. Because 
this is the second value written in the sequence, the PIC routes the 
value to ICW2, 


This base interrupt vector refers to the interrupt vector for interrupt 
input zero. To generate a unique interrupt vector number for each inter- 
rupt input, the PIC ORs the interrupt input number (0-7) and the base 
interrupt vector number. Therefore, the base interrupt vector must be 
modulo 8. 


4. The fourth instruction is dependent upon whether the PIC is a master or 
a slave. Because this is the third value written in the sequence and 
ICW1 indicated a cascade mode, the PIC routes the value to ICW3. 
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e If the PIC is a master, each bit set in the value indicates that the 
corresponding interrupt input is connected to a slave PIC. For the 
— VAXmate, only bit 2 is set. 
e If the PIC is a slave, the value is the slave identification. The slave 
identification is a value between 0 and 7 inclusive, and corresponds to 
the master interrupt input to which it is connected. 


JDO ICO IOI ESO IGI IG IG IO I ok II ICICI ge ok ok kok ok ao ok ok ake ake ake ke ait ie ok ake ok keke feo ake ok ak ake ake ake ake ate / 


/* pic_initQ - initialize master and slave pics + | 
[RIGO IG I Gk kok kk kkk ak ak dade desea de tek ak ake / 


void pic_init() /* initialize all pics */ 
{ 
int i; /* variable for loop control */ 
int intr_flg; /* to hold CPU IF state */ 
register PIC_DAT «ppd; /* pointer to PIC data */ 
register PIC *pps; /* pointer PIC I/O structure */ 
outp(allpics[0].base, Ox1i1); /* write master ICW1 is cascade */ 
outp(allpics[1i].base, 0x11); /* write slave ICW1 is cascade */ 
intr_flg = int_off(); /* turn CPU interrupts off */ 
for(i = 0: i < NPIC; i++) 
{ 
ppd = &alipics[i]; /* assign pointer to PIC data */ 
pps = ppd->base; /* assign pointer to I/0 ports */ 
outp(&pps->porti, ppd->icw2); /* write ICW2 */ 
outp(&pps->porti, ppd->icw3); /* write ICW3 */ 
outp(&pps->porti, ppd->icw4) ; /* write ICW4 */ 
outp(&pps->porti, Oxff) ; /* mask all interrupts */ 
} 
int_on(intr_flg); /* turn CPU interrupts on */ 
} 


5. The fifth instruction writes the ICW4 value to port 1. 


¢ Bit 0 determines the microprocessor family. In this case, it is set and 
indicates the 8086/80286 mode. 


end-of-interrupt command after the interrupt is processed. 


* Bits 2 and 3 are clear, indicating the nonbuffered mode of operation. 
For the VAXmate, a permanent hardware connection determines the 
master/slave relationship. 


e Bit 4 is clear, indicating that the PIC is not in special-fully-nested 


mode. 
e All other bits are not used and are clear. 
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6. The sixth instruction masks (disables) all interrupts. The interrupt inputs 
must be unmasked before the PIC can generate an interrupt to the CPU. 


To complete the initialization, the last instruction enables CPU interrupts. 
Because the PIC interrupt mask is cleared during initialization, it is possible 
that the PIC will recognize an active interrupt input between instructions 5 and 
6. Before a PIC interrupt input is unmasked, an interrupt handler must be 
available and the appropriate interrupt vector initialized. 


A PIC interrupt input that is not active long enough to be latched is considered 
a glitch. If a glitch occurs, the PIC generates an interrupt for 1RQ7 (master) or 
IRQ15 (slave). To determine whether an interrupt for IRQ7 or IRQ15 is a 
glitch, test ISR bit 7 of the appropriate controller. If the ISR bit 7 is set, the 
interrupt is a valid interrupt. If the ISR bit 7 is clear, the interrupt is a glitch. 


Issuing an End-of-Interrupt Command 


In fully nested mode (default mode), the PIC processes the highest priority in- 
terrupt that is pending. When the PIC receives a nonspecific end-of-interrupt 
(EOI), it clears the highest priority bit that is set in the in-service register. 
Until no interrupts are pending, the PIC continues by processing the highest 
priority interrupt that is pending. 


To allow the PIC to process the same interrupt or an interrupt of lower prior- 
ity, the eoi function is called at the end of an interrupt handling sequence. The 
calling parameter indicates which PIC issued the interrupt. If an interrupt is 
issued by the slave PIC, an EOI must be issued to the slave and then to the 


master. 


During interrupt processing, it is possible for a higher priority interrupt to 
become active, If this happens, the PIC attempts nesting the interrupts. For 
the PIC to nest interrupts, the CPU interrupt request input must be enabled. 
Otherwise, the CPU will not issue the required acknowledge sequence. During 
the interrupt processing, the CPU automatically stacks its current state and 
clears the interrupt enable flag. Because none of the interrupt handlers, in 
these examples, enable the CPU interrupt request input, nesting of interrupts 
is effectively disabled. 


Masking Interrupts 


The function imask masks or unmasks a bit in the interrupt mask register 
(OCW1). The calling parameters indicate the PIC number, the bit number (0-7), 
and whether the bit should be masked or unmasked. : 
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/* eoi() - establish End-Of-Interrupt for pic(s) */ 


{3 OR ok OR RO OR IOI ok kok ak ka ok ok ok ako oko ak: okc akc ak: ake okt coke ofe ake aks ake ale ake ake ote ake aks ake ake ke ote ote // 
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void eoi(pic) /* send nonspecific EOI */ 
int pic; /* which pic handled interrupt */ 


1 


outp(&(allpics[pic].base)->portO, EOI); /* write eoi as indicated */ 
if (pic) /* was it the slave pic ? */ 
outp(&(allpics[0].base)->portO, EOI); /* write eoi to master */ 

} 
[DIC OOO IO OIG OO OOOO OOO kk dk dali GG a doko ak kok di kk ae ake / 
/* imask() - mask or unmask desired bit in pic mask register * / 


JRO ORO OOO ICO tok ok IO dO ok ko dodo iokoisioioi dato at silo kokode i dak sk alee ake eat // 


void imask(pic, bitno, enable) /* set or clear bit in mask */ 

/* register of desired pic */ 
int pic; /* which pic 7 */ 
int bitno; /* which bit 7 */ 
int enable; /* enable or disable ? */ 


{ 


unsigned char current; /* current contents of MR */ 
unsigned char mask; /* the mask to write */ 
register PIC *pps; /* pointer PIC I/O structure «/ 
pps = allpics[pic]. base; /* assign pointer to I/0 ports */ 
current = inp(&pps->port1) ; /* read current mask */ 
mask = 1 << bitno; /* set up correct bit */ 
if(enable) current &= “mask; /* clear the bit */ 
else current |= mask; /* or set it */ 
outp(&pps->porti, current); /* write the resulting mask */ 
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Overview 


Chapter 4 
DMA Controller 


The direct-memory-access (DMA) controller is an Intel 8237A-5, programmable, 
DMA controller operating at 4 MHz. The DMA controller allows the direct 
transfer of 8-bit data between DMA-capable, input/output (I/O) devices and 
memory. The DMA controller has four, independent DMA channels. Table 4-1 
lists the assignment of the four DMA request lines. Each channel has 16 ad- 
dress lines and an external 8-bit page register. Thus, each channel can transfer 
a maximum of 64 Kbytes anywhere in the 16 Mbyte address range. 


The following list shows the operational modes and restrictions of the DMA 


controller, 


Single transfer 


Block transfer 


Demand transfer 


Cascade 
Compressed timing 
Memory to memory 


Extended write cycle 


This is the suggested mode of operation. 


To prevent interference with DRAM refresh cycles, 
limit block transfers to 8 transfers per block. 


To prevent interference with the DRAM refresh 
cycle, limit demand transfers to 8 transfers per 
demand. 


As bus master, the slave DMA controller should re- 
lease the bus after 10 ws. 


Compressed timing is not supported by the processor 
board hardware. 


Memory-to-memory transfers are not supported by 
the processor hardware. 


The extended-write cycle does not provide sufficient 
data setup time. Use the normal DMA write cycle. 


DMA Controller - Hardware Description 4-] 


Table 4-1 DMA Request Line Assignments 


Channel Rsguest Line 

0 Avalilable 

] Available 

2 Diskette Controller 
c Available 
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Additional Source of Information 


The following Intel Corporation document provides additional information: 


¢ Microsystem Components Handbook (Publication Number 230843) 


Operation 


When the DMA controller receives a DMA request from a peripheral device, 
the DMA controller sends a hold request signal to the CPU. When the CPU 
responds with a hold acknowledge signal, the DMA controller takes control of 
the I/O data bus, the system address bus, and the control bus. The controller 
then generates a 16-bit memory address and activates the corresponding DMA 
acknowledge line, the I/O read or write line, and the memory read or write line. 
On seeing the DMA acknowledge, the DMA-capable I/O device transfers (reads 
or writes) the data on the data bus. Thus, the data is transferred directly be- 
tween the I/O device and memory. 


The DMA controller operates in two major cycles, idle and active. Each DMA 
cycle can assume seven, separate states. Each state is composed of one full, 
clock period. Table 4-2 describes the various controller states. 


Table 4-2 DMA Controller States 


scssiniesintnamnes 
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State pest spron 
SI This is the inactive state. No valid DMA scennsers are pending and the 


CPU can program the DMA controller. 


SO This is the first active state of DMA service. The controller has re- 
quested a CPU hold, but the CPU has not acknowledged a hold. 
Programming of the DMA controller can continue until the acknowl- 
edge is received. 


S1-S4 These are the DMA working states. 


SW When more time is required to complete a transfer, wait states are 
inserted between S2 and 83, or $3 and S4. 
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Idle Cycle 


When none of the I/O channels is requesting DMA service, the DMA controller 
enters the idle cycle and performs SI states. At each clock cycle in the idle 
cycle, the DMA controller samples the DMA request lines and the chip select 
line. 


If a DMA request line becomes active, the DMA controller goes to the active 
state. Otherwise, if CPU has selected the DMA controller and the CPU has 
control of the bus, the CPU can read or write the DMA controller internal 
registers, 


Active Cycle 


When the DMA controller is in the idle cycle and a nonmasked channel 
requests DMA service, the controller issues a hold request to the CPU and 
enters the active cycle. The DMA service will then occur in one of the four 
following modes. 


Single Transfer Mode 

The DMA controller is programmed to perform only one transfer in this mode. 
After the transfer, the word count is decremented and the address is either 
decremented or incremented. When the word count goes from QOOOH to 
FFFFH, a terminal count (TC) signal is generated, and will auto-initialize the 
channel to its original condition if it had been programmed to do so. 


The ROM BIOS uses this mode for data transfers between the diskette control- 
ler and memory. 


Block Transfer Mode 

In this mode, the DMA controller is activated by a DMA request to continue 
making transfers until a TC (word count has reached FFFFH) or an external 
end-of-process (EOP) signal occurs. If the channel has been programmed for 
auto-initialization, the auto-initialization occurs at TC or EOP. This mode 
should be limited to eight transfers (assuming no additional wait states) to pre- 
vent interference with refresh cycles. 


Demand Transfer Mode 

The DMA controller performs transfers until a TC or external EOP occurs, or 
until there is no DMA request. Transfers may continue until the I/O device has 
exhausted its data capacity. Once the I/O device has caught up. DMA service is 
reestablished by means of a DMA request. The intermediate values of address 
and word count are stored in DMA controller internal registers between serv- 
ices while the CPU is running. At the end of the service. only an EOP can 
cause auto-initialization to occur. This mode should be limited to eight transfers 
per demand to prevent interference with refresh cycles. 
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Cascade Mode 

This mode is used when DMA controllers are cascaded for system expansion. 
In this configuration, the initial controller determines the priority of the addi- 
tional controllers. Each of the additional controllers establish priority within 
themselves and make the DMA request to the initial controller. The initial con- 
troller does not output any address or control signals, since they could conflict 
with the outputs of the added controller. 


Data Transfers 


The DMA controller can perform read, write, or verify operations in each 
transfer mode. Read transfers move data from memory to an I/O device; write 
transfers move data from an I/O device to memory; and verify transfers are 
pseudo data transfers. In verify mode, the controller operates as if in read or 
write mode, however the memory and I/O control lines are not active. 


Memory-to-memory transfers are a special case of DMA transfer. Channel 0 is 
the source and channel | is the target. In memory-to-memory transfers, chan- 
nel 0 uses one cycle to read the data byte and store it in the temporary regis- 


register to the target location. 


Auto-Initialize 

Restores the DMA channel to its original condition following an EOP. Auto- 
initialization is accomplished by restoring the original values of the Current 
Address and Current Word Count registers from the Base Address and Base 
Word Count registers. The CPU loads the current registers and base registers 
which do not change during the DMA service. When the channel is in auto- 
initialize mode, the mask bit is not set. After auto-initialization and a receipt of 
a DMA request, the channel can perform DMA service without CPU 
intervention. 
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Priority 
The two types of priority, fixed and rotating, are defined as follows: 


Fixed Priority In fixed priority, the channels are placed in order based 
on the descending value of their assigned number. The 
assigned number range is from zero to three (0-3), with 
zero as the highest priority. 

Rotating Priority The channel being serviced is assigned lowest priority 
value, and all others rotate to the next higher value. 


Address Generation 

The eight, high-order address bits (15-8) are multiplexed on the I/O data lines. 
At the S1 state, the high-order 8-bits are output to an external latch and 
placed on the system address bus. The low-order bits are output directly from 
the DMA controller to the system address bus. For multiple transfers, such as 
block and demand transfers, the addresses are generated sequentially. The data 
in the external latch (high-order byte) can remain the same for many transfers, 
and have to be changed only when a borrow or carry takes place in the normal 
sequence of addresses. The controller executes S1 states only when updating of 
the high-order byte is required. 
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Table 4-3 DMA Controller and Page Register Address iad 


Port R/W 
0000 00H | WwW 
R 
O0001LH WwW 
R 
0002H W 
R 
0003H W 
R 
0004H W 
R 
0005H W 
lai 
0006H WwW 
R 
0007H W 
R 
0008H W 
R 
0009H W 
QOOOAH W 
QOOOBH W 
00O0OCH W 
R 
O0O0DH W 
QOOEH W 
QOOOFH W 
O080H W 
0081H W 
0082H W 
0083H W 
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Register 
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Base and Current aiidvees 
Current address 


Base and Current word count 
Current word count 


Base and Current address 
Current address 


Base and Current word count 
Current word count 


Base and Current address 
Current address 


Base and Current word count 
Current word count 


Base and Current address 
Current address 


Base and Current word count 
Current word count 


Command 
Status 


Request 
Write single mask register bit 
Mode register 


Clear byte pointer flip/flop 
Temporary 


Master clear 

Clear mask register 

Write all mask register bits 
Channel | page register 
Channel 2 page register 
Channel 3 page register 


Channel 0 page register 


eae semana inn 
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Registers 


The DMA controller has 16 I/O ports to access 26 internal registers. 
Additionally, the DMA circuitry has four I/O ports to access four page regis- 
ters, Table 4-3 lists the I/O ports and the registers accessed. 


Base and Current Address Register 
(0000H/0002H/0004H/0006H) 
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LOW BYTE OF ADDRESS 
READ OR WRITTEN FIRST 
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HIGH BYTE OF ADDRESS 
READ OR WRITTEN SECOND 


4 ee SN eT a, es eRe Seeks Mee en (ne ara ee 


Each DMA channel has a 16-bit base address register and a 16-bit current ad- 
dress register. The base address register contains the initial value. Writing a 
value to the base address register initializes the current address register to the 
same value. The current address register is incremented or decremented after 
each transfer. When the required number of transfers have occurred and if 
auto-initialize (see the mode register) is enabled, the current register is in- 
itialized from the base register. 


Before performing a 16-bit read or write, clear the byte pointer flip/flop. 

To write a base register, write two, 8-bit bytes in succession to the same port. 
To read a current register, read two, 8-bit bytes in succession to the same port. 
In either case, the low byte is accessed first and then the high byte. 
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Base and Current Word Register 
(0001 H/0003H/0005H/0007H) 
7 6 5 4 3 2 1 0 
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LOW BYTE OF CURRENT WORD 
READ OR WRITTEN FIRST 
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HIGH BYTE OF CURRENT WORD 
READ OR WRITTEN SECOND 


Each DMA channel has a 16-bit base word count register and a 16-bit current 
word count register. The value written to this register determines the number 
of transfers performed. The number of transfers is the programmed value plus 
one. The current word count is decremented after each transfer. When the cur- 
rent word count is decremented below zero (FFFFH), a terminal count is gener- 
ated. When the required number of transfers have occurred and if auto-initialize 
(see the mode register) is enabled, the current register is initialized from the 
base register. 


To write a base register, write two, 8-bit bytes in succession to the same port. 
To read a current register, read two, 8-bit bytes in succession to the same port. 
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Command Register (0008H) 


7 


6 2 4 3 2 1 0 


Bit 


7 


R/W_ Description 


Ww 


Ww 


WwW 


WwW 


DACK SENSE - DMA Acknowledge Sense 
0 = DACK sense active low 

1 = DACK sense active high 
DREQ SENSE - DMA Request Sense 
0 = DREQ sense active high 

1 = DREQ sense active low 

WRITE SELECT 

Q = Late write selected 

1 = Extended write selected 


For the VAXmate workstation. the extended write mode does not 
provide an adequate write cycle. Use only the late write mode. 


If bit 3 equals 1 (compressed mode), bit 5 is a don’t care value. 
However, the VAXmate workstation is not capable of using: com- 
pressed mode. 


PR - Priority 
Q = Fixed priority 0 (highest), 1, 2, and 3 (lowest) 
1 = Rotating priority 


Initially, the priority is the same order as in fixed priority. In the 
rotating priority scheme, the currently serviced DMA channel be- 
comes the lowest priority channel. However. the channels always 
maintain their priority in numeric order. That is, the priority de- 
creases as the channel number increases and wraps between chan- 
nels 3 and 0. 
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Bit R/W_ Description (Command Register - cont.) 
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3 WwW TIMING 
Q = Normal read/write timing - A read/write cycle requires a 
minimum of three clock cycles and is subject to wait states. 
The VAXmate workstation uses this mode. 
1 = Compressed read/write timing - A read/write cycle occurs in 
two clock cycles. The VAXmate workstation is not capable of 
using compressed mode. 
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If bit O equals 1 (memory-to-memory enabled), bit 3 (timing) is a 
don’t care value. 


Zz W CE - Controller Enable 
QO = Controller disabled 
1 = Controller enabled 


| W CHANNEL 0 ADDRESS HOLD 
Q = Disable channel 0 address hold 
1 = Enable channel 0 address hold 


Channel 0 address hold causes the DMA controller to copy a single 
byte to the specified number of destination bytes. 


If bit 0 equals 0 (memory-to-memory disabled), bit 1 (channel 0 ad- 
dress hold) is a don’t care value. 


0 W MEMORY-TO-MEMORY 
0 = Memory-to-memory transfers disabled 
1 = Memory-to-memory transfers enabled 


The VAXmate workstation does not support memory-to-memory 
transfers. 
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This 8-bit register controls the operation of the DMA controller. It is cleared by 
a hardware reset or a master clear instruction. 
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Write Single Mask Bit (QOOAH) 
7 6 5 4 | 2 1 0 


Bit R/W_ Description 
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7-309 W DON’T CARE (any value) 


2 Ww MASK BIT 
0 = Enable the selected channel 
1 = Disable the selected channel 


10 W CHANNEL SELECT 
00 = Select channel 0 mask bit 
01 = Select channel 1 mask bit 
10 = Select channel 2 mask bit 
11 = Select channel 3 mask bit 
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request. These bits are set if their associated channel produces an EOP and 
auto-initialize is not enabled. 


Write All Mask Bits (QO0FH) 
7 6 5 4 3 2 1 0 


DON’T CARE 


| MASK BITS 
| CHANNEL CHANNEL CHANNEL CHANNEL 
3 2 1 0) 


Bit R/W_ Description 
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7-4. = W DON’T CARE (any value) 

3-0 W MASK BITS 
Q = Enable the indicated channel (CHANNEL 3-0) 
1 = Disable the indicated channel (CHANNEL 3-0) 
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Mode Register (000BH) 


J 


Bit 


7-6 


3-2 


1-0 


OPERATION 
MODE 


6 5 4 3 2 1 0 


R/W_ Description 


Ww 
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OPERATION MODE 
Q0O = Demand mode 
01 = Single mode 
10 = Block mode 
11 = Cascade mode 


INCR/DECR SELECT - Increment/Decrement selection 
0 = Increment selected 
1 = Decrement selected 


AUTO INIT - Auto-initialization enable 
Q = Disable auto-initialization 
1 = Enable auto-initialization 


TRANSFER TYPE 
00 = Verify 

Ol = #£4Write 

10 = #£=Read 

11 = Invalid value 


A read transfer moves data from memory to the I/O device. A 
write transfer moves data from the I/O device to memory. That is, 
the orientation is from the I/O device, not the CPU. 

If bits 7-6 equal. 11, then the transfer type is a don’t care value. 
CHANNEL SELECT 

00 = Channel 0 selected 

01 = Channel 1 selected 

10 = Channel 2 selected 

11 = Channel 3 selectec 


Each DMA channel has a 6-bit mode register. Register selection is 
determined by bits 1 and 0. 
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Request Register (0009H) 
7 6 5 4 3 2 1 0 
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DON’T CARE 
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Bit R/W_ Description 
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7-3 W DON’T CARE (any value) 


ps Ww REQUEST BIT 
Q = Reset the indicated request bit 
1 = Set the indicated request bit 


1-0 W CHANNEL SELECT 
00 = Channel 0 
01 = Channel | 
10 = Channel 2 
li = ~Channel 3 
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The DMA controller responds to requests for DMA service from both software 
and the DMA request signal. Each channel has a request bit that can be set or 
reset as determined by the Request register. These bits are not maskable and 
are subject to prioritization. 
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Status Register (Q008H) 
7 6 5 4 3 2 0 
Ne a 
DMA REQUEST PENDING TERMINAL COUNT REACHED | 


|CHANNEL CHANNEL CHANNEL CHANNEL|CHANNEL CHANNEL CHANNEL CHANNEL 


. 2 1 0 3 2 1 0 
re Kee eee Lee ee een! (Ree ee eee ee (ae en Sareea 


Bit R/W_ Description 
7-4 RR DMA REQUEST PEN DING 
Q = Indicated channel does not have a request pending 
(CHANNEL 3-0) 
1 = Indicated channel has a request pending (CHANNEL 3-0) 


3-0 R TERMINAL COUNT REACHED 
Q = Indicated channel has not reached the terminal count 
(CHANNEL 3-0) 
1 = Indicated channel has reached the terminal count or external 
EOP PaDRHES ee ANNEL 3-0) 


setae sunning iebantinn ne reeimnytemntgannenerstetonsnnninecennennent seseasansantemsc abuses esc tenance neeoencingatnnnsasedronienrseraretoonsyinnvocmene esa eet teense 
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Temporary Register (QOO0CH) 
7 6 5 4 3 2 1 0 


DATA 


Bit R/W_ Description 


7-0 R Last data byte transferred in a memory-to-memory transfer 


Between the read and write cycles of a memory-to-memory transfer, the DMA 
controller stores the source byte in this register. This register is cleared by a 
hardware reset or a master clear. 
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Programming Example 


The following programming example demonstrates: 


e Initializing the 8237A DMA controller 
¢ Enabling and disabling a channel 
¢ Preparing a channel for data transfer 


The example provides routines as described in the following list: 


dma_ init Resets the DMA controller. 
dma_open Enables the indicated DMA channel. 


dma transfer Prepares the indicated channel for data transfer. 


dma_close Disables the indicated channel. 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


Constant Values 


The constant values DMA_PAGE0 through DMA_PAGE3 define the I/O ad- 
dress of the indicated page register. The values CHANNELO through 
CHANNEL1 define the channel select bit values for the mode, mask, and 
request registers. The values MTM ENA through BIT SET define the bit 
values for various conditions of the command, status, mode, and request 
registers. 


/ the oe oe ok Se ote oe ok ok oie oe oe oie ode he Se oie DD coe oie oe oe oe oe oie ke ok oe we oe he oe oo oR ok ee oie oe oie a ok fe oe te ke it ok ie okt ote ic ok oi BR oie oe Oe oie ae ok oe oie oie oo of / 


/* define constants used in 8237 DMA example 
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I/O address 
I/O address 
I/O address 
I/O address 


#define DMA_PAGEO 0x83 /* DMA page register 
#define DMA_PAGE1 0x80 /* DMA page register 
#define DMA_PAGE2 0x81 /* DMA page register 
#define DMA_PAGE3 0x82 /* DMA page register 


m © 


fj ND 


#define CHANNELO 0x00 /* select channel O bit value 
#define CHANNEL1 Ox0i /* select channel 1 bit value 
#define CHANNEL2 0x02 /* select channel 2 bit value 
#define CHANNEL3 0x03 /* select channel 3 bit value 


/ 
+f 
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/* command register bit definitions */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


/* status register bit definitions */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


/* mode 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


MTM_ENA 


HOLD_ENA 


DMA_DIS 
C_TIME 

ROT_PRI 
EXTD_WR 
DREQ_LO 
DACK_HI 


CH2_TC 
CH3_TC 
CHO_REQ 
CH1_REQ 
CH2_REQ 
CH3_REQ 


register 


TRAN_VR 
TRAN_WR 
TRAN_RD 
AUTO_TE 
ADR_DEC 
MODE_DM 
MODE_SI 
MODE_BK 
MODE_CS 


/* request register bits */ 
#define BIT_SET 0x04 
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Ox01 /* Memory~to-memory enable */ 
0x02 /* channel O hold address enable */ 
0x04 /* dma controller disable */ 
0x08 /* compressed timing */ 
0x10 /* rotating priority */ 
0x20 /* extended write */ 
0x40 /* DREQ active when low */ 
0x80 /* DACK active when high */ 
Ox01 /* channel O has reached terminal count */ 
0x02 /* channel 2 has reached terminal count */ 
0x04 /* channel 3 has reached terminal count */ 
0x08 /* channel 4 has reached terminal count */ 
0x10 /* channel O requesting service */ 
0x20 /* channel 1 requesting service */ 
0x40 /* channel 2 requesting service */ 
0x80 /* channel 3 requesting service */ 
bit definitions */ 
0x00 /* verify transfer */ 
0x04 /* write transfer */ 
0x08 /* read transfer */ 
0x10 /* auto-initialize enable */ 
0x20 /* address decrement */ 
0x00 /* demand mode */ 
0x40 /* single mode */ 
0x80 /* block mode */ 
OxCO /* cascade mode */ 
/* set selected mask bit */ 
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Data Structures 


The structure DMA CHANNEL resembles the I/O space of the address and 
word count registers for a channel. Multiple instances of this structure are used 
in the declaration of the DMA_CONTROLLER structure. The 
DMA_CONTROLLER structure defines the I/O space of DMA controller inter- 
nal registers. The value DMA_ BASE defines the base address for referencing 
the structure DMA CONTROLLER. 


DGG GIGI IGG oI iC a ok kok ki Gk ok kok Ik a ak ake ake tak kek ke ake ake kok ac fe ake ake ote te / 


/* declare structures used in 8237 DMA example * f 
[CRO ook GO ok ok okok a Gk i kokokokoak ok ok kk a ica ak ok ak ak ak ak ok aka ak oki ae ake ok teak ake ke // 


typedef struct /* define dma channel I/0 structure */ 
{ 
unsigned char bc_addr; /* write base address, read current address */ 
unsigned char bc_word; /* write base word, read current word */ 


} DMA_CHANNEL ; 


typedef struct /* define dma controller I/O structure */ 

{ 
DMA_CHANNEL chO; /* channel zero registers */ 
DMA_CHANNEL ch1; /* channel one registers */ 
DMA_CHANNEL ch2; /* channel two registers */ 
DMA_CHANNEL ch3; /* channel three registers */ 
unsigned char csr; /* write control, read status */ 
unsigned char req; /* write request register */ 
unsigned char wsmb; /* write single mask bit */ 
unsigned char mode; /* write mode register */ 
unsigned char temp;/* write clears byte pointer flip-flop, read temp */ 
unsigned char master_clr; /* write master clear/reset */ 
unsigned char clr_mask; /* clear all mask bits */ 
unsigned char wr_mask; /* write all mask bits */ 


#define DMA_BASE (DMA_CONTROLLER *)0x0000 /* base address */ 
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Initializing the DMA Controller 


The DMA controller is initialized by issuing a MASTER CLEAR instruction. 
This clears all bits in the command register and effectively disables the control- 


that the controller is disabled. 


j* ve she she ode ake oho ode ofe he sk ote she ke oe oe He oe ok vie oe ate he ne he oe oe ke ote he oe ofc ode sic ote the ote oe the oe ake ole: ole ake oe ale ole oie ole ble oe de oe Bt ke oe oie dhe ie oe He ode oe ole ode te oe le he ode x f 


/* dma_init() - initialize the 8237 DMA controller  f 
OOO IOC IOC IORI OO IOI IOI III ICG IO ICI a sok a keke ak a eae ts / 


dma_init() 


{ | 
DMA_CONTROLLER *pdc = DMA_BASE; /* point to DMA controller */ 


outp(&pdc->master_clr, 0); /* reset DMA controller */ 
outp(&pdc->csr, 0); all command register bits to 0 */ 


ee 
BB 
2 
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4-18 DMA Controller - Programming Example 


Opening a DMA Channel 


The dma_open function assumes that the channel is currently disabled. It 
writes valid values to the registers that control the indicated channel. 


For this C compiler, offset 0 in the data segment is used only for monitoring 
NULL pointers. With a zero word count, an inadvertent data transfer can move 
only one byte before expiring. 


The last instruction enables the indicated channel. 
JOC CO OO kok Gok ki dokok ok kek ok kak ok ok ok ak ak aici ok ok ak ak akc ok ae ake ake oko ak akc ak ae as ak cafe ake ok ke ac ate ae a / 


/* dma_open() - open a DMA channel * / 


JOO OOO Ik kook cK kok Gi kak kk a kk ok a a ae ake ak ak otek te ak ote ake ake / 


dma_open (channel) 


int channel; /* which DMA channel to open */ 
{ 

DMA_CONTROLLER *pdc = DMA_BASE; /* point to DMA controller */ 
DMA_CHANNEL *pch; /* pointer to a channel structure * / 
int i; /* loop control */ 


for(i = channel, pch = &pdc->chO; i; i--) /* discover which channel */ 


pcht+; /* point to next channel */ 
outp(&pdc->mode, channel) ; /* clear mode register for this channel */ 
outp(&pdc->req, channel); /* clear channel request for this channel */ 
outp(&pdc->temp, 0); /* clear first/last flip-flop */ 
outp(&pch->bec_addr, 0); /* write 0 to low byte */ 
outp(&pch->bc_addr, 0); /* write O to high byte */ 
outp(&pdc->temp, 0); /* clear first/last flip-flop */ 
outp(&pch->bc_word, 0); /* write 0 to low byte */ 
outp(&pch->bc_word, 0); /* write O to high byte */ 
outp(&pdc->wsmb, channel) ; /* clear mask bit for this channel */ 
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Preparing a Channel for Data Transfer 


The dma_transfer function prepares a channel for data transfer. Next, the func- 
tion disables the channel. It then initializes the page, address, word count, and 


mode registers. 


NOTE 


Before writing a 16-bit register, the byte pointer flip/flop must 
be cleared. This sequence loads the two sequential bytes in the 
correct locations. Because interrupt processing could disrupt the 
process, the dma_transfer function disables CPU interrupts 
before clearing the byte pointer flip/flop. Interrupts are not 
enabled until after the 16-bit registers have been written. 


[SCISSOR OIC Sr OI dor IO dk sk ok desk ak a ak ak ok fe ok ake ieake ok ok ake cake ake ak ok ake oka / 
/* dma_transfer() - set parameters for a DMA transfer * | 
SOO OOOO IOI ISOC ICICI ICICI SGI ICICI ISI II III ICICI ICH ak ak ak ake ak ak ake / 
dma_transfer(channel, page val, addr, count, ttype) 
int channel; /* transfer on which DMA channel ? */ 
int page_val; /* page register contents */ 
unsigned char *addr; /* transfer address */ 
unsigned int count; /* count to transfer */ 
int ttype; /* transfer type */ 
DMA_CONTROLLER *pdc = DMA_BASE; /* point to DMA controller */ 
DMA_CHANNEL *pch; /* pointer to a channel structure */ 
unsigned int page_reg; /* which page register to write */ 
int ch_mode; /* channels mode */ 
int intr_flag; /* to hold CPU IF state *«/ 
switch(channel) /* which channel 7? */ 
case 0: /* channel 0 ? */ 
pch = &pdc->ch0O; /* point to channel O registers */ 
page_reg = DMA_PAGEO; /* set page register address */ 
ch_mode = QO; /* auto-initialize & increment/decrement */ 


break; 
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case 1: /* channel 1 ? 
pch = &pde->chli; _/* point to channel 1 registers * 
page_reg = DMA_PAGE1,; /* set page register address » 
ch_mode = 0; /* auto-initialize & increment/decrement * 
break; 

case 2: /* channel 2 ? » 
pch = &pdc->ch2; /* point to channel 2 registers 
page_reg = DMA_PAGE2; /* set page register address »* 
ch_mode = MODE_ST; /* auto-initialize & increment/decrement 
break; 

case 3: /* channel 3 ? > 
pch = &pdc->ch3; /* point to channel 3 registers » 
page_reg = DMA_PAGES3; /* set page register address * 
ch_mode = 0; /* auto-initialize & increment/decrement * 
break; 


} 


outp(&pdc->wsmb, BIT_SET | channel);/* set mask bit for this channel * 


outp(&pdc->req, channel); /* clear channel request for this channel 


outp(&pdc->mode, ttype | ch _mode | channel) ; /* set mode register 

intr_flag = int_off(); /* no interrupts please * 
outp(&pdc~>temp, 0); /* clear first/last flip-flop - 
outp(&pch->bc_addr, (unsigned int)addr & Oxff); /* write low byte * 
outp(&pch->be_addr, (unsigned int)addr >> 8); /* write high byte + 
outp(&pch->bc_word, count & Oxff); /* write low byte 

outp(&pch->bc_word, count >> 8); /* write high byte - 
int_on(intr_flag) ; /* allow interrupts * 
outp(page_reg, page_val); /* write the page register * 
outp(&pdc->wsmb, channel) ; /* clear mask bit for this channel > 
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Disabling a DMA Channel 


The dma_close function closes the channel by masking (disabling) that chan- 
nel’s request input line. 


RIO IOI I III IC IC a ek ok ok ok 9 ok ok ok ok ok ok oe oe fe akc akc akc ak oko akc ake ke ake ake akc ake Se oe ac eo oe eae ok fe a ae ake ake ake / 


/* dma_close() - close a DMA channel * / 
JDO RIOR GIO IGOR DOG GI kd ok cd fod ak ok de dt ke ako ak oi de ak ac ake a Jk ak ke ic ak ake ois ae ak eke ae a ake 


dma_close(channel) 
unsigned char channel; /* which DMA channel to close */ 


{ 
DMA_CONTROLLER *pdc = DMA_BASE; /* point to DMA controller */ 


outp(&pdc->wsmb, BIT_SET | channel);/* set mask bit for this channel */ 
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Chapter 5 
Real-Time Clock 
and CMOS RAM 


Overview 
The VAXmate processor board contains an MC146818 real-time clock. The real- 
time clock has the following features: 

¢ Time-of-day clock with alarm and 100-year calendar 

« Counts seconds, minutes, and hours of the day 


¢ Counts days of the week, days of the month, month, and year with auto- 
matic end-of-month and leap year recognition 


¢ Binary or binary-coded-decimal (BCD) representation of date, time, and 
alarm (the ROM BIOS and MS-DOS use BCD). 


e 24-hour clock or 12-hour clock with a.m./p.m. indication 
¢ Daylight savings time option 

e Internal time base and oscillator 

¢ External time base 32.768 KHz crystal 


* 64 byte, low-power, static RAM (14 bytes of registers and 50 bytes of 
general purpose RAM) 


e Square wave generator 
* Programmable interrupts 


- Time-of-day alarm, once-per-second to once-per-day 
- Periodic interrupt rates from 30.5 us to 500 ms 
End-of-update interrupt 
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Additional Source of Information 


The following Motorola Inc. document provides additional information on pro- 
gramming the real-time clock. 


e 8-Bit Microprocessor & Peripheral Data 


Battery-Backup Considerations 

To keep time and maintain RAM when system power is off, the real-time clock 
requires a battery-backup source. The two lithium batteries in the VAXmate 
expansion box provide the only battery power source. 


NOTE 

The lithium battery used in the VAXmate expansion box has an 
operational life expectancy of 6 years and a shelf life of 10 
years, 


Addressing the Real-Time Clock 


The real-time clock (RTC) is addressed by the contents of an 8-bit latch at I/O 
port 0070H and the RTC data is read or written through I/O port 0071H. 


NOTE 

The RTC address latch is write only. Bit 7 of the RTC address 
latch (1/O port 0070H) is the nonmaskable interrupt (NMI) mask 
register. If bit 7 equals zero, the NMI is enabled. Otherwise, the 
NMI is disabled. For more information about the nonmaskable 
interrupt, see Chapters 3 and 15. 


The RTC dedicates the first 14 bytes of RAM (OOH through 0DH) as registers 
for the real-time clock functions. The remaining 50 bytes of RAM (OEH 
through 3FH) are not dedicated to the RTC. Table 5-1 describes the RTC ad- 
dress map. 
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Table 5-1 Real-Time Clock Address Map 
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Latch Value R/W Location Accessed 
OOH R/W Seconds register 

O1H R/W Seconds alarm register 
02H R/W Minutes register 

03H R/W Minutes alarm register 
04H R/W Hours register 

05H | R/W Hours alarm 

06H R/W Day-of-week register 
07H R/W Day-of-month register 
O8H R/W Month register 

09H R/W Year register 

OAH R/W Register A 

OBH R/W Register B 

OCH R/W Register C 

ODH R/W Register D 

QOEH-3FH R/W Remaining 50 bytes of RTC RAM * 


. * See the definition of the structure RTC in the programming example. 
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Real-Time Clock Registers 


The real-time clock (RTC) has two types of registers: 


¢ Data (locations OOH through 09H) 
¢ Control and status (locations OAH through 0DH) 


dates, the RTC disconnects the data registers from the RTC bus. The specifics 
of data register processing are discussed later. 


The control and status registers are available at all times. 
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Register A 


Addressing - Write 0AH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7. 6 5 4 2 2 1 0 
a ae tr re 


DIVIDER SELECTION BITS RATE SELECTION BITS 
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7 R/W_ UIP - Update In Progress 
0 = For ie time bases, at least 244 ws remain before the update 
cycle begins. The data registers are available for reading. 
| = Update cycle is in progress or begins in less then 244 ws. 


The UIP bit is a read-only bit. For the 32.768 KHz time base, the 
update cycle time is 1984 ys. Writing a 1 to the Register B SET 
bit inhibits the update cycle and clears the UIP status bit. A hard- 
ware reset does not modify the UIP bit. 

6-4 R/W DIVIDER SELECTION BITS 
These bits identify the time base to use. Writing 111 to these bits 
resets the divider. One second after removing the divider reset, the 
first update cycle begins. For the VAXmate workstation time base 
of 32.768 KHz, set these bits to 010. A hardware reset does not 
modify the DIVIDER SELECTION bits. 

3-0 R/W RATE SELECTION BITS 


These bits select one of 15 taps on a 22-stage divider or disable 
the divider. Table 5-2 shows the bit values for the possible inter- 
rupt rates. A hardware reset does not modify the RATE 
SELECTION bits. On powerup, the ROM BIOS sets these bits to 
Q. 
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Table 5-2. Rate Selection Bits 
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Periodic inieeeant Rate 
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None (divider disabled) 
3.90625 us 
7.8125 us 

122.070 us 

244.141 us 

488.281 wus 

976.562 us 

1.953125 ms 
3.90625 ms 
7.8125 ms 

15.625 ms 
31.250 ms 
62.5 ms 

125.0 ms 

250.0 ms 

500.0 ms 
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Register B 


Addressing - Write OBH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7 6 8, 4 3 2 1 0 


Bit R/W_ Description 


0 = Allow update cycles to occur once per second 

1 = Abort any update cycle in progress and inhibit update cycles 
until cleared. (This allows initialization of the date, time, and 
alarm registers.) 


A hardware reset does not modify the SET bit. 


R/W_ PIE - Periodic Interrupt Enable 
Q = Disable periodic interrupts (default value) 
1 = Enable periodic interrupts at the rate specified by RS3-RSO 
in Register A 


>) 


A hardware reset clears the PIE bit to 0. 


5 R/W_ AIE - Alarm Interrupt Enable 
Q = Disable alarm interrupts (default value) 

1 = Enable alarm interrupts, (The interrupt frequency depends on 

the contents of the alarm registers.) 


A hardware reset clears the AIE bit to 0. 


4 R/W_ UIE - Update-ended Interrupt Enable 
0 = Disable the update-ended interrupt (default value) 
1 = Enable the update-ended interrupt 


A hardware reset or setting the register B SET bit clears the UIE 
bit to 0. 


3 R/W SQWE - Square Wave Enable 
0 = Disable the square-wave output (default value) 
1 = Enable the square-wave output 


The square-wave output is not connected to anything, so the 


SQWE bit should always be written as 0. A hardware reset clears 
the SQWE bit to 0. 
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Bit R/W_ Description (Register B - cont.) 


Z R/W DM - Data Mode 
0 = Binary-coded-decimal (BCD) data format used for date, time, 
and alarm registers 
1 = Binary data format used for date, time, and alarm registers 


A hardware reset does not modify the DM bit. However, the ROM 
BIOS clears DM to 0. 


1 R/W HM - Hour Mode 
0 = Hours register and hours alarm register use a 12-hour clock 
with a.m. or p.m. indication 
1 = Hours register and hours alarm register use a 24-hour clock 


A hardware reset does not modify the HM bit. However, the ROM 
BIOS sets HM equal to 1. 


0 R/W DSE - Daylight Savings Enable 
Q = Disable daylight savings 
1 = Enable daylight savings. Daylight savings changes occur at 2 
a.m. on the last Sunday in April and the last Sunday in 
October. 


A hardware reset does not modify the DSE bit. However, the 
ROM BIOS clears DSE to 0. 
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Register C 


Addressing - Write 0CH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7 6 5 4 3 2 1 0 


Bit R/W Description 


7 R/W_ IRQF - Interrupt Request Flag 
When one or more of the following conditions are true, the RTC 
sets the IRQF bit to 1: 
PIF = PIE = | 
AIF = AIE = 1 
UIF = UIE = 1 
R/W_ PIF - Periodic Interrupt Flag 
When register B, bit PIE equals 1, the PIF bit indicates the state 
of the periodic interrupt. If PIF equals 1, the RTC sets IRQF. 
Register A bits RS3-RSO establish the rate of this interrupt. 
R/W_ AIF - Alarm Interrupt Flag 
When register B, bit AIE equals 1, the AIF indicates the state of 
the alarm interrupt. When AIF equals 1, the current time matches 
the alarm time and the RTC sets IRQF. 
4 R/W_ UIF - Update-ended Interrupt Flag 
When register B. bit AIE equals 1, the UIF bit indicates the state 
of the update-ended interrupt. At the end of each update cycle, the 
RTC sets this bit to 1 and sets IRQF. 
3-0 R/W Always 0 
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to Register B does not modify the bits in Register C. 
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Register D 


Addressing - Write 0DH to address latch at 0070H. 
Data - Read or write data at address 0071H. 


7 6 5 4 3 2 1 0 


Bit R/W_ Description 
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7 RIW VRT- Valid RAM and Time 


0 = Since the last time this register was read, the power-sense 
circuitry detected a loss of power to the RTC. The RTC reg- 
isters and RAM contain invalid data. 

1 = Since the last time this register was read, power to the RTC 
has remained stable. 


Reading this register sets the VRT bit. It is the only way to set ° 
the VRT bit. After setting the date, time, or alarm, read this regis- 
ter so that the VRT bit indicates that the registers are valid. 


A hardware reset does not modify the VRT bit. 
6-0 R/W Always 0 
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Real-Time Clock Data Registers 


The real-time clock (RTC) formats the date and time in either binary or binary- 
coded-decimal (BCD). All data registers (OOH through 09H) must use the same 
format. If the data format is changed, the data registers must be initialized in 
the new format. The ROM BIOS uses the BCD data format. Bit 2 of register 
B controls the format. 


The HOUR MODE bit in Register B controls the range of the hour and hour 
alarm registers. When the HOUR MODE bit is set (1), the hour and hour 
alarm registers have the range 0-23. When the HOUR MODE bit is clear (0), 
the hour and hour alarm registers have the ranges 1-12 (a.m.) and 129-140 
(p.m.). 

The hours, minutes, and seconds alarm registers have an additional range of 
COH-FFH. This is an alarm register don’t care code. For more information, see 


the alarm description. Table 5-3 shows the format and ranges of the data 
registers, 
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Table 5-3 RTC Data Register Ranges 
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Latch Register Function Binary Range BCD Range 

Value 

OOH Seconds All modes 0-59 OOH-59H 

O1H Seconds Specific time 0-59 QOH-59H 
Alarm 

Each second 192-255 COH-FFH 
02H Minutes All modes 0-59 OOH-59H 
03H Minutes Specific time 0-59 QOH-59H 

Alarm 

Each minute 192-255 COH-FFH 
04H Hours 24-hour mode 0-23 OOH-23H 

12-hour mode a.m. 1-12 O1H-12H 

12-hour mode p.m. 129-140 81H-92H 
05H Hours Alarm = Specific time 0-23 OOH-23H 

(24-hour mode) 

Specific time (12-hour 1-12 QLH-12H 

mode a.m.) 

Specific time (12-hour 129-140 81H-92H 

mode p.m.} 

Each hour (all modes) 192-255 COH-FFH 
06H Day-of-Week 1-7 O1H-07H 
O7H Day-of-Month 1-31 OLH-31H 
08H Month 1-12 O1H-12H 


09H Year 0-99 O0OH-99H 
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Alarms 


During each real-time clock (RTC) update cycle, the RTC compares the hour, 
minute, and second registers to the corresponding alarm registers. If all of the 
time registers match all of the alarm registers, the RTC sets the register C 
AIF. If, when this occurs, the register B alarm interrupt enable (AIE) bit is 
enabled, the alarm interrupt triggers IRQ8. 


An alarm register value in the range COH-FFH is a don’t care code. When an 
alarm register contains a don’t care code, that alarm register matches any 
value in the corresponding time register. 


Table 5-4 shows the eight different types of automatic alarm cycles provided by 
the real-time clock (RTC). 


Table 5-4 RTC Automatic Alarm Cycles 


eesti ssn erent 


Minute Alarm Second 
Alarm 


seen erent moe etarernemnene-anecnesetnn tpn 


Cycle Description Hour Alarm 


asinine nr iain nntanennenanainennunernornsishaniseoneshe estonia nets vainennaatanon 


Once per second every second 


Once per second for a 
one-minute span every hour 


Once per second for a one- 
minute span every 24 hours 


Once per second for a one-hour 
span every 24 hours 


Once per minute every minute 


Once per minute for a one-hour 
span every 24 hours 


Once per hour every hour 


Once every 24 hours 


COH-FFH 
COH-FFH 


Specified 
Specified 


COH-FFH 
Specified 


COH-FFH 
Specified 


COH-FFH 
Specified 


Specified 


COH-FFH 


COH-FFH 


Specified 
Specified 


COH-FFH 
COH-FFH 


COH-FFH 
COH-FFH 


Specified 
Specified 


Specified 
Specified 


eons mri gion a nee eterna ecrisneiewnees eerste eames aio iinet asia hii Sic i i ia niece eR ANE 


Also, there is a nonautomatic way to use the alarm function. To use this 


method, set a specific alarm time. At each subsequent alarm interrupt, set the 


next specific alarm time. 
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idesanand me 


32. 768 KHz time bs ase, - the ane i cyc le regains 1948, US. "ake once a 
comprises the following: steps: 


° 


The RTC sets (1) the register A UIP bit. 
After 244 us, the RTC disconnects the data registers from the external 
bus and connects them to the internal bus. 


The RTC checks for an overflow condition. If no overflow condition exists, 
the RTC goes to the next step. Otherwise, the RTC zeros the register 
and increments the next register in the series. 


The RTC compares the hour, minute, and seconds registers to the cor- 
responding alarm registers. If a match occurs for all three registers, the 
RTC sets (1) the register C alarm flag (AIF). 


The RTC disconnects the data registers from the internal bus and con- 
nects them to the external bus. 


The RTC clears (0) the register A UIP bit. 
The RTC sets (1) the register C update-ended interrupt flag (UIF) 


During an update cycle, the data registers are disconnected from the external 
bus. Therefore, while an update is in progress, reading or writing a data regis- 
ter produces invalid results. Use one of the following methods to avoid update 
cycles: 


Monitor the register A update-in-progress (UIP) bit. The update cycle 
begins 244 us after the RTC sets the UIP bit. Thus, if the UIP bit is 
clear, the data registers will remain valid for at least 244 us. 


Enable the update-ended interrupt. This interrupt occurs after every 
update cycle. The date and time registers remain valid for over 999 ms 
after the RTC sets the UIF. If the processor must handle an excessive 
amount of interrupts, the interrupt handler for the RTC should also moni- 
tor the UIP bit. 


Monitor the register C periodic interrupt flag (PIF). The periodic interrupt 
is synchronized with the update cycle. For any given periodic interrupt, 
there is a time after the interrupt when the data registers are valid. For a 
32.768 KHz time base, use only the rates between 3.90625 ms and 500 
ms. Use the following formula to calculate the valid time span: 


Time Span = 244 us + (RATE / 2) 
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Interrupts 


Periodic Interrupt 


fied by the RATE SELECT bits in register A. 


Update-Ended Interrupt 


If the UIE bit is set (1), the update-ended interrupt triggers IRQ8 once per 
second. The next RTC update cycle starts 1000 ms after the update-ended 
interrupt. 


Alarm Interrupt 


During each RTC update cycle. the RTC compares the hour, minute, and 
second registers to the corresponding alarm register. If the time and alarm reg- 
isters match and if the AIE bit is set (1), the alarm interrupt triggers IRQ8. 


5- 14 Real-time Clock and CMOS RAM - Hardware Description 


Programming Example 


The real-time clock (RTC) programming example demonstrates: 


e Reading and writing the RTC registers and RAM 

¢ Handling RTC interrupts 

e Interpreting the data stored in the RTC RAM 

¢ Calculating the checksum that ensures data integrity 


The next programming example provides the following routines: 


rd_rtc 
wr_rtc 
rtc_cksum 
btb 


bed 
rd_date 
rd_ time 


shw_date 
shw_time 
shw_ddtyp 
shw_hdtyp 
rtc_int_hand 
shw_hdw 


rtc_init 
rtc_rest 


rtc 


Reads the indicated RTC register or RAM location 
Writes the indicated RTC register or RAM location 
Returns the calculated RTC RAM checksum 


Returns the binary equivalent of a binary-coded decimal 
(BCD) value 


Returns the binary-coded decimal (BCD) equivalent of a 
binary value 


Reads the date-related registers and stores the results in 
the indicated structure 


Reads the time-related registers and stores the results in 
the indicated structure 


Displays the current date at location 0,0 
Displays the current time at location 0,72 
Displays the diskette drive types 

Displays the hard disk drive types 

Handles hardware interrupts from the RTC 
Displays the hardware setup from RTC RAM 


Initializes the RTC interrupt vector (70H) and the RTC 
alarm registers 

Restores the RTC interrupt vector (70H) and disables clock 
interrupts 


Provides menu selection of the examples and executes the 
examples 
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CAUTION 
Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the next programming example is limited to the context pro- 
vided in this manual. No other use is intended. 


Constant Values 


The file (kyb.h) that is included defines constant values for function keys, See 
Chapter 8 for information about keyboard programming. 


The file (example.h) that is included defines the structure type MESSAGE that 
is used to display the menu. | 


The constant values CKSUM_ START and CKSUM_ END define the start and 
end offsets of the RTC RAM that is under checksum control. If any value in 
this range is changed, a new checksum must be written to reflect this change. 


The constant values UIP through VRT define bit values for registers A through 
D. The value DIVIDE SEL defines the divider that divides the base input fre- 
quency for the internal RTC operation. This value is related to the VAXmate 
hardware design and should be considered a fixed value. 
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#include "kyb.h" 
#include "“example.h" 


/* reference function key constants */ 


/* reference menu structure */ 


/ ROO GO ROG IG OO kk doko Ok a doi doa ak koko acc ak ake akc ekki ee ok ok akc ake oe aft ae fe ok ake akc ae ate ake ke / 


/* define constants used in RTC example 


“/ 


[DOO GO oO I IO IOI OI ICICI i i ao ica ak ok i a ake ak ok ake ake ake ake / 


#define CKSUM_START 0x10 
#define CKSUM_END 0x20 


/* define register A bit 
#define UIP 0x80 
#Hdefine DIVIDE_SEL 0x20 
#define RATE_SEL 0x0d 


/* define register B bit 


#define SET_UPD 0x80 
#define PIE 0x40 
#define AIE 0x20 
#define UIE 0x10 
#define SQWE 0x08 
#define DAT_MOD 0x04 
#define CLK24 0x02 
#define DSE Ox01 


/* define register C bit 


#define IRQF 0x80 
#define PIF 0x40 
#define AIF 0x20 
#define UIF 0x10 


/* define register D bit 


#define VRT 0x80 
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values */ 


values */ 


values */ 


values */ 


/* offset of start of checksum area */ 


/* offset of end 


of checksum area 


/* update in progress bit 


/* FIXED VALUE - Hardware related 


/* Programmer defined interrupt rate * 


/* disable updating of date & time * 
/* Periodic Interrupt Enable 


/* Update-Ended Interrupt Enable * 
/* Square Wave Enable * 


/* Alarm Interrupt Enable 


/* Data mode (BCD = 0, Binary = 1) 


/* 


{12-hour clock 


i 


/* Interrupt Request Flag + 
/* Periodic Interrupt Flag 


/* Alarm Interrupt Flag 
/* Update-Ended Flag 


/* Valid Ram & Time bit 


O, 24 hour = 1 * 
/* Daylight Savings Enable 


/ 


/ 
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Data Structures 


The structure type RTC defines the I/O space that accesses the real-time clock, 
The offset within the real-time clock (OOH-3FH) is written to an 8-bit latch that 
addresses the real-time clock. This latch is located at I/O address 0070H. Data 
is read or written through I/O address 0071H. 


The structure type CMOS defines how each RAM location is used within the 


ters. The remaining 50 bytes of RAM are defined according to industry- 
standard usage. 


The structure type DATIM provides a consistent format for moving date and 
time information. 


/ OOo oko oko ok oka ok io dok ook ak dodo ok ok kook skook ok ok ake ok ok ok ac ake ak ake oke ok ok ac ade ak ake akc ak ok / 


/* declare structures used in RTC example «/ 
JC IOI III IGO kk dk kok fk AC IO I do a a ak ok aks ak ake otek ake ke ake ke ok / 


typedef struct 


{ 
unsigned char addr_port; /* write RTC/CMOS address to this port */ 
unsigned char data_port; /* read/write data through this port */ 
} RTC; 


typedef struct 


{ 
unsigned char seconds; /* seconds (0-59) current time */ 
unsigned char alr_sec; /* seconds alarm */ 
unsigned char minutes; /* minutes (0-59) current time */ 
unsigned char alr_min; /* minutes alarm */ 
unsigned char hours; /* hours (0-11/23) current time */ 
unsigned char alr_hr; /* hours alarm */ 
unsigned char dow; /* day-of-week (1-7) */ 
unsigned char dom; /* day-of-month (1-28/29/30/31) */ 
unsigned char month; /* month (1-12) current date */ 
unsigned char year; /* year (0-99) current date */ 
unsigned char rega; /* register A */ 
unsigned char regb; /* register B */ 
unsigned char regc; /* register C */ 
unsigned char regd; /* register D */ 
unsigned char diag; /* diagnostics byte */ 
unsigned char reset; /* reason for reset */ 
unsigned char ddtyp; /* diskette drive type */ 
unsigned char reservl; /* reserved byte */ 
unsigned char hdtyp; /* hard disk type */ 
unsigned char reserv2; /* reserved byte */ 
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unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


} CMOS; 


typedef 


{ 


char 
char 
char 
char 
char 
char 
char 
char 
char 
char 
char 
char 
char 


struct 


int seconds; 
int minutes; 
int hours; 


int dow; 
int dom; 


int month: 


int year; 


} DATIM; 
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syscfig; 
bmem1; 
bmemh; 
lemem1; 
lememh; 


reserv3[Ox2e ~ 0x19]; 


cksumh; 
cksuml1; 
hemem1; 
hememh; 


century; 


info; 


reserv4[0x40 - 0x34]; 


/* system configuration byte 

/* base memory size low byte 

/* base memory size high byte 

/* expansion memory size low byte 
/* expansion memory size high byte 
/* reserved 
/* high byte of checksum (always 0) 
/* low byte of checksum 

/* expansion memory size low byte 


/* expansion memory size high byte > 


/* century byte of date (19 from 1986) 


/* information flag 
/* reserved 


/* seconds (0-59) 
/* minutes (0-59) 
/* hours (0-11/23) 
/* day-of-week (1-7) 
/* day-of-month (1-28/29/30/31) 
/* month (1-12) 


* year (century * 100 + year register) 


* f 
* f 
*/ 
* 
«/ 
* / 
* / 
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Reading the Registers and RAM 
The function rd_rtc reads the indicated byte of real-time clock RAM, Before 


accessing the byte, the offset is compared to the range OOH-09H. This is the 


offset range of the data registers, which are invalid during update cycles. If the 
offset falls within this range, the read is synchronized with the update-in- 
progress bit. 


JRO IOI ICI OO IOI OIG I IO kok ak tek sk ak sk sk dokede ak ak ski ke ake ak ak ok ae ake ake ak / 
/* rd_rtc() - read. an RTC byte (if date or time, monitor UIP bit) +f 
(DOOR OO I IO IOI FIO OR ICO ICO I i iO SOIC OR I IOI I IC aca a I i ak ak kk ak a ak ee ok ke take ake / 
int rd_rtc(offset) /* read RTC byte */ 
int offset; /* byte offset to read */ 
{ 
RTC *prtc; /* ptr to address & data ports */ 
CMOS *pcmos; /* ptr to RTC/CMOS structure */ 
unsigned int intr_flg; /* CPU IF state */ 
unsigned char retval; /* value to return */ 
prte = (RTC *)0x70; /* assign I/O address */ 
pemos = 0; /* structure offset is zero */ 
if(offset < (int) (épcmos->rega) ) /* need to monitor UIP ? */ 
{ 
while(1) /* break out when ready */ 
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{ 
intr_flg = int_off(); 


outp(&prtc->addr_port, &pcmos~>rega) ; 
if (inp(&prtc->data_port) & UIP) 


int_on(intr_flg); 
else break; 
} 
} 
else intr_flg = int_off(); 


outp(&prtc->addr_port, offset); 
retval = inp(&prtc->data_port) : 


int_on(intr_flg): 
return(retval); 


/* no interrupts allowed * 


/* set to reg A 
/* test UIP bit 
/* allow interrupts 


/* no interrupts allowed * 


/* set to desired offset 


/* read data 


/* allow interrupts 
/* return data byte 
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Writing the Registers and RAM 


The function wr_rte writes the indicated byte of real-time clock RAM. Before 
accessing the byte, the offset is compared to the range 0OH-O9H. This is the 
offset range of the data registers, which are invalid during update cycles. If the 
offset falls within this range, the write is synchronized with the update-in- 
progress bit. 


/* wr_rtc() - write an RTC byte of 
JCI CIO OR GGG oS ok oO oko lok Ok koko ici ke de sk kick ae ak ak ak ake ok ake ake aie / 


void wr_rtc(offset, value) /* write RTC byte */ 
int offset; /* offset to write */ 
unsigned char value; /* byte value to write */ 
{ 
RTC *prtc; /* ptr to address & data ports */ 
CMOS *pcmos; /* ptr to RTC/CMOS structure */ 
unsigned int intr_flg; /* CPU IF state */ 
prtc = (RTC *)0Ox70; /* assign I/O address */ 
pemos = 0; /* structure offset is zero */ 
if(offset < (int) (&pcmos->rega) ) /* need to monitor UIP ? */ 
{ 
while(1) /* break out when ready */ 
‘ 
intr_flg = int_offQ); /* no interrupts allowed */ 
outp(&prtc->addr_port, &pcmos->rega) ; /* set to reg A */ 
if (inp(&prtc~>data_port) & UIP) /* test UIP bit */ 
int_on(intr_flg) ; /* allow interrupts */ 
else break; 
} 
} 
else intr_flg = int_off(); /* no interrupts allowed */ 
outp(&prtc->addr_port, offset); /* set to desired offset */ 
outp(&prtc->data_port, value) ; /* write data */ 
int_on(intr_flg) ; /* allow interrupts */ 
} 
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iho 


Calculating the Checksum 


The function rtc_cksum calculates the checksum and returns the result to the 
caller. The checksum is the sum, modulo 256, of all bytes in the range 


/D OR koko kkk dk dk da tot doko i ak ok ac ok ok akc ok ok ak ok akc ok ok ake ok ok ake ok ok kc ake oe ake fe ak ake ode ake ake ode ade oke fe ake fe ae akc ae ae ake ake akc ake ake ke 


/* xrtc_cksum() - calculate the CMOS checksum and return its value +f 
[DOOR RO GIG IO OGIO OR ICICI OO I IO CAG GI IG IOI ICCC a akc He ake oe ake ok ke ake ake ode ake ae ake / 


unsigned char rtc_cksum() /* calculate the CMOS checksum */ 


{ 


int i; /* loop control */ 
unsigned char sum; /* accumulates the checksum */ 
sum = 0; /* sum starts out zero */ 
for(i = CKSUM_START; i <= CKSUM_END; i++) /* all checksum bytes */ 
sum += rd_rtc(i); /* read data and add to sum */ 
return(sum) ; /* return calculated checksum */ 


} 
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Converting Binary-Coded Data 


The ROM BIOS defines the data mode as binary-coded decimal (BCD) and 

therefore, so does this example. This requires converting between BCD and 
binary. The function btb converts a BCD value to its binary equivalent. The 
function bed converts a binary value to its BCD equivalent. 


JOR oko doko kook iG i kk gkok ok ok a ia ak keke ake de ak ok keke ok fe ake ake oso ok akc ak oe ae ade te ake ke / 


/* btb - convert bcd value to binary integer value +f 
JOR ok Og oko dokokokok a iGo kode ak ak ak ake aks oki ke ate ok te ate / 


btb(bcd_val) /* bed to binary integer */ 
unsigned char bcd_val; /* bed value */ 
{ /* assume valid bcd value */ 


return(((bcd_val >> 4) * 10) + (bcd_val & OxOf)):; 
} 


[DOO oo doko ok IG oko okokk ok dokokok a dak iok deed dok dea ak kes / 


/* bed -~ convert binary value to bcd value + f 
/ Ok ROO OOO OK ORC OI ICE kok I I OK aC icc aca te afc ake ak ak afr ate ake / 


unsigned char bcd(val) /* binary to bed */ 
unsigned char val; /* binary value */ 
{ /* assume valid bcd value */ 


unsigned char tmp; 


tmp = (val / 10) << 4; /* tens in upper nibble */ 
tmp |= val % 10; /* ones in lower nibble */ 
return (tmp) ; /* return BCD value */ 


} 


— 
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Reading the Date 


The function rd_date reads all of the date-related registers and stores the 
results in the DATIM structure pointed to by the calling parameter. It can be 
called at any time without restriction. 


The century byte is not a real-time clock register. The century byte is an 
industry-standard location that overcomes the 100-year calendar limitation. It 
must be updated manually or by software. 


JOC IGO OO OIG OO OO OIG I ok GG kok GG a ok ki i ik ake ok odo ak ak ak kak ok ak ak ake / 


/* rd_date() - read date and write to DATIM structure +f 
(CIO CIO IO OC Oo ick ok IG GO Ick ke deici ake ac a k tek eat tek / 


void rd_date (pd) /* read the date */ 

DATIM *pd; /* where to store data */ 

{ 

CMOS *pcmos; /* ptr to RTC/CMOS structure */ 
pcmos = 0; /* structure offset is zero */ 
pd->dow = btb(rd_rtc (&pcmos->dow) ) ; /* day-of-week */ 
pd->dom = btb(rd_rtc(&pcmos~->dom) ) ; /* day-of-month */ 
pd->month = btb(rd_rtc(&pcmos->month)); /* month */ 
pd->year = btb(rd_rtc(&pcmos->century)) * 100; /* century */ 
pd->year += btb(rd_rtc(&pcmos->year)) ; /* year */ 

} 
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Reading the Time 


The function rd_ time reads all of the time-related registers and stores the 


results in the DATIM structure pointed to by the calling parameter. This func- 
tion assumes the use of the 24-hour clock mode. It can be called at any time 
without restriction. 

J ste te oe ee he ae oe he he it whe oe oe she he she he he oe he et he oooh he oe He te ke he he ote oe oe es oe ee oe ee oe oe ke he oe oe ee se oe he Re he oe he ole hc ie oe eee / 


/* rd_time() ~- read time and write to DATIM structure * f 


void rd_time (pd) /* read the time */ 
DATIM *pd; /* where to store data */ 
{ 


CMOS *pcmos; /* ptr to RTC/CMOS structure */ 


pcmos = 0; /* structure offset is zero */ 
pd->seconds = btb(rd_rtc (&pcmos->seconds) ) ; /* seconds */ 
pd->minutes = btb(rd_rtc(&pcmos->minutes) ) ; /* minutes */ 
pd->hours = btb(rd_rtc(&pcmos->hours)) ; /* hours */ 
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Displaying the Date 


The function shw_ date displays the current date starting at row 0 and column 
0. It can be called at any time without restriction. 


JARO OO CIC OI i tok i koko i ki acacia dokoiog ak ak a a i aie ac fe aks aks ake ake ake aks ake ok ake ak de ac ale oe ake ake / 


/* define some day and month names * / 


char day_name[8][10] = 
{ 


"Invalid" , /* rtc is 1 based */ 
"Sunday" , "Monday", "Tuesday", "Wednesday", 
"Thursday", "Friday", "Saturday" 


}; 


char month_name[13][10] = 
4 


"Invalid", /* rtc is 1 based */ 
"January" , "February", "March", MApril® , 

"May" , "June" , "July" . "August", 

"September", "October" , "November", "December" 


iS 


(DG OR OOOO ICO ICC ok doko do ooo kok iio a aca i ae ocak ke desk ak ake asic 7/ 
/* shw_date - show date starting at row O column 0 + / 


DRO RO ICI IGG IGG IG Ok ok kok ok kok kok kak ok ak dk ake ak ok ke fcc de ak dc akc fe oi fe ae oe fe ae ak ake ake akc akc akc keke ake / 


shw_date() 
{ 


DATIM dt; /* date and time structure */ 
char sdate[50] ; /* place to store output */ 
rd_date(&dt) ; /* read current date */ 


sprintf(sdate, "49s %9s 42d, 404d", &day_name[dt.dow] [0], 
&month_name[dt.month] [0], dt.dom, dt.year); 
disp_str(0, 0, sdate); /* display it */ 
} 
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Displaying the Time 


The function shw_time displays the current time starting at row 0 and column 
72, It can be called at any time without restriction. 


/ Ook ok kok obo GG io ok dokokokokoiok i io iok dk ak ak ako ak ok ak ak oi de oko oke akc ake akc ake oie ake akc ake akc de ae cake ake ake / 
/* shw_time - show time on row O column (last_column ~- 7) * f 


{0k kkk kok kok kk kok kok kok doko oko kok kok ak okok kak kok ok kok kok ak kok ok akc akc ok kak ok ake ok akc ake ak akc ok kc ode te ke ake oe ake te ake / 


shw_time() 


< 

DATIM dt; /* date and time structure */ 

char stime[50] ; /* place to store output */ 
rd_time(&dt); /* read current time */ 
sprintf(stime, "42d:%,02d:%02d", dt.hours, dt.minutes, dt.seconds) ; 
disp_str(0O, 72, stime) ; /* display it */ 

} 


Real-time Clock and CMOS RAM - Programming Example 5 - 27 


Displaying the Diskette Drive Type 

The function shw_ddtyp is a text-formatting subroutine that generates the 
diskette drive type according to the calling parameters. It is only called by the 
function shw_hdw. 


/ OR RGR Ok SI kk ok ok ake ok fe ake ake ok ote akg ok ok ake ke ak ake ok ok kok akc ake ake ae ae ofc ak kc akc akc deat oft oft akc akc ok ic ofc oe oe akc ake fe ot fe ok nc ak ake oie ok ok akc ake / 


/* shw_ddtyp - show diskette drive type 


*/ 


JOR OR OIG ICO Gioia kok kG ak i ki ded ok kok ak ok ok ok a ick doko ke akc ok aks akc oof oe fe oe oe oe ake ake aks ake akc ake ak akc ok ake ake oe ke ok // 


void shw_ddtyp(pc, ddtyp, drive) /* show diskette drive type 


char *pc; /* buffer to write to 
char ddtyp; /* diskette drive type 
char drive; /* drive letter 


int i; /* temp for index 


i = sprintf(pc, "Diskette drive {c is ", drive); /* general opening 
switch(ddtyp) 
{ 
case 0: | /* no drive 
sprintf(&pc[i], "non-existent") ; 
break; 


case 1: /* 48 tpi dedd 
sprintf (&pc[i], "48-TPI double sided") ; 
break; 


case 2: /* 96 tpi dsdd hc 
sprintf (&pc[i], "an RX33 96-TPI double-sided, high-capacity") ; 
break; 


default: /* unknown type 


sprintf(épc[i], "an unknown type"); 
break; 


- 28 Real-time Clock and CMOS RAM - Programming Example 


md 


ae / 


oe / 


*/ 


+ f 


* f 


Displaying the Hard Disk Type 


disk drive type according to the calling parameters. It is only called by the 
function shw_hdw. 


{AGRIC OO IOC OOOO IO OO IC ICH ici dokoie ici aca a / 
/* shw_hdtyp - show hard disk type «ff 
[DSCC ORIG SIRO Ok i iok kd dee ak acdc ak ae ake ae ak te / 


void shw_hdtyp(pc, hdtyp, drive) /* show hard disk type */ 


char *pc; 


char hdtyp; /* hard disk type */ 
char drive; /* drive letter */ 


{ 


int i: 


i = sprintf(pc, "Hard disk drive 4c is ", drive); 


if(hdtyp) sprintf(&pcl[i], "type %d", hdtyp); /* drive type */ 
else sprintf(&pc[i], "non-existent") ; /* no drive */ 


} 
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i AEA 
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Handling the Clock Interrupts 


and periodic interrupt flag (PIF). After handling the interrupts, the interrupt 
handler notifies the interrupt controller. 


The update-ended interrupt occurs once per second. At each interrupt, the in- 
terrupt handler increments the global flag, time flag, to indicate that at least 
one second has elapsed. 


The alarm interrupt is initialized to the first second of every day. At each inter- 
rupt, the interrupt handler increments the global flag, date flag, to indicate 
that at least one day has elapsed. 


The periodic interrupt is initialized to a rate of 125 ms. At each interrupt, the 
interrupt handler increments the global counter, metronome. The 8254 timer 
and speaker example in Chapter 6 uses this counter for output timing. Also, 
the periodic interrupt handler calls unbeep. If required, unbeep turns off the 
bell (beep sound). The example programs use the speaker to generate a bell 
(beep sound). 
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/* rtc_int_hand() - real-time clock interrupt handler */ 
int time_flag; /* 1 second update flag */ 
int date_flag; /* 1 day update flag */ 
unsigned int metronome; /* timer for sound output */ 
int motor_flag; /* timer for diskette drive motors */ 
int head_settle; /* head settle timer for diskette drives */ 
void rtc_int_hand() /* rtc int handler */ 
{ 

CMOS *pcmos; /* ptr to RTC/CMOS structure */ 
unsigned char tmp; /* temp to read in reg C */ 
pemos = 0; /* structure offset is zero */ 
tmp = rd_rtc(&pcmos->regc) ; /* read current interrupt requests */ 
if(tmp & UIF) time_flagt++; /* time updates once per second */ 
if(tmp & AIF) date_flagt+; /* alarm set for once per day at 00:00:00 */ 
if(tmp & PIF) /* periodic interrupt 7? */ 

3 
metronome+t ; /* increment timing for speaker demo */ 
unbeep() ; /* unbeep turns off speaker if bell */ 
if (motor_flag) /* if timing diskette drive motors */ 
if (--motor_flag == 0) /* if timed out */ 
motor_off(); /* call routine to turn motors off */ 
if (head_settle) /* if timing head settle */ 
head_settle--; /* reduce count */ 

} 
eoi(i); /* end of interrupt for interrupt controller */ 

} 


gia a 
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unsigned int ui; 
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Interpreting the RAM Contents 


The function shw_hdw interprets the industry-standard locations in the real- 
time clock RAM and displays the results. The ROM BIOS interprets this data 
in the same manner. 
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/* sh_hdw() - show hardware setup in CMOS */ 


/DO OR oO ook kokokokdodok ok dokok kkk ok lok kook kok dG IG Ca ae a oi ok a ok oki a ait afc ac ok ak a ak fg ae ake ake ake ake / 


sh_hdw() 
{ 


/* to hold CMOS byte read */ 
/* to hold memory size */ 

CMOS *pcmos; /* ptr to RTC/CMOS structure */ 

char *pc; 

char line[512]; 


unsigned char tmp; 


#define ROW 16 
#Hdefine COL 17 


pemos = 0; /* structure offset is zero */ 
tmp = rd_rtc(&pcmos->syscfg) ; /* read system config */ 
sprintf(line, "id diskette drive(s) present", (tmp >> 6) + 1); 
disp_str(ROW, COL, line); 
switch((tmp & 0x30) >> 4) /* check video type */ 
{ 
case 0: /* not a valid type */ 
pe = "Invalid video type"; | 
break; 


case 1: 
pe = "40 column color graphics"; 
break; 


case 2: 
pe = "80 column color graphics"; 
break; 


case 3: 
pc = "Monochrome adapter with parallel port"; 
break; 

} 
disp_str(ROW + 1, COL, pc); 
tmp = rd_rtc(&pcmos->ddtyp) ; 


/* display video type */ 
/* read diskette drive types */ 
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shw_ddtyp(line, tmp >> 4, ‘A’); /* get drive a type */ 
disp_str(ROW + 2, COL, line); /* display drive a type */ 
shw_ddtyp(line, tmp & Ox0f, 'B’); /* get drive b type */ 
disp_str(ROW + 3, COL, line); /* display drive b type */ 
tmp = rd_rtc(&pcmos~>hdtyp) ; /* read hard disk types */ 
shw_hdtyp(line, tmp >> 4, 'C’); /* get drive c type */ 
disp_str(ROW + 4, COL, line); /* display drive c type */ 
shw_hdtyp(line, tmp & OxOf, ’D’); /* get drive d type */ 
disp_str(ROW + 5, COL, line); /* display drive d type */ 
tmp = rd_rtc(&pcmos->bmemh) ; /* base memory high byte */ 
ui = (unsigned int)tmp << 8; /* shift and assign */ 
tmp = rd_rtc(&pcmos->bmem1) ; /* base memory low byte */ 
ui |= (unsigned int) tmp; /* add low byte */ 
sprintf(line, "Base memory = {dK bytes", ui); 

disp_str(ROW + 5, COL, line); /* display base memory */ 
tmp = rd_rtc(&pcmos->lememh) ; /* expanded memory high byte */ 
ui = (unsigned int)tmp << 8; /* shift and assign */ 
tmp = rd_rtc(&pcmos~->lemem]) ; /* expanded memory low byte */ 
ui |= (unsigned int) tmp; /* add low byte */ 
sprintf(line, "Expansion memory = %dK bytes", ui) ; 

disp_str(ROW + 6, COL, line); /* display expanded memory */ 
tmp = rd_rtc(&pcmos~->hememh) ; /* expanded memory high byte */ 
ui = (unsigned int)tmp << 8; /* shift and assign */ 
tmp = rd_rtc(&pcmos~->hemem]) ; /* expanded memory low byte */ 
ui |= (unsigned int)tmp; /* add low byte */ 
sprintf(line, "Expansion memory = %4dK bytes", ui); 

disp_str(ROW + 7, COL, line); /* display expanded memory */ 
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Initializing the Real-Time Clock 


Disables real-time clock interrupts and update cycles 
Initializes the processor interrupt vector, the real-time clock control, and 
alarm registers; and unmasks the interrupt controller input 

¢ Enables the real-time clock interrupts and update cycles 


/ Oko doko ook ok do kok kok do kkok kokolok do oko dk ok i kok ok ok ese ok aC kok ok sk ake ak ako ok ak sk ak ok ak kok / 


/* rtc_init() - initialize alarms and vectors * f 
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rte init?) 
{ 
CMOS *pcmos; /* ptr to RTC/CMOS structure */ 


pemos = 0; /* structure offset is zero */ 
wr_rtc(&pcmos~->regb, SET_UPD | CLK24); /* prepare to init */ 
imask(1, 0, 0); /* disable PIC interrupt */ 


iv_init (0x70) ; /* initialize RTC interrupt vector */ 
wr_rtc(&pcmos->rega, DIVIDE_SEL | RATE_SEL) ; /* set pi rate */ 
wr_rtc(&pcmos->alr_hr, 0x00); /* write hours alarm */ 
wr_rtc(&pcmos~->alr_min, 0x00); /* write minutes alarm */ 
wr_rtc(&pcemos~>alr_sec, 0x00); /* write seconds alarm */ 


wr_rtc(&pcmos->regb, AIE | UIE | PIE | CLK24 _ ); /* enable clock */ 
imask(1, 0, 1); /* enable PIC interrupt */ 
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Restoring the Interrupt Vectors 


To shut down real-time clock interrupt processing, the rtc_rest function: 
* Disables the real-time clock interrupts 
e Masks the interrupt controller input 
« Restores the interrupt vector to its previous condition 


NOTE 


clock stops. 


/ ORR kk kk gk kok kok a ke akok ke kok kok ak ak akok ok ok kook ak ck ok ok kc ake ake kok ok oe akc ake ke ke ok ake ok ake ate ake // 
/* rtc_rest() - disable interrupts and restore vectors *f 
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rtc_rest() 


{ 


CMOS *pcmos; /* ptr to RTC/CMOS structure */ 
pcmos = QO; /* structure offset is zero */ 
wr_rtc(&pcmos->regb, CLK24) ; /* disable clock interrupts */ 
imask(1i, 0, 0); /* disable PIC interrupt */ 
iv_rest (0x70) ; /* restore interrupt vector */ 
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Real-Time Clock Example 


The function rte displays the menu, accepts input, and executes the examples. 


J 30k RO sok tok kook kook Oe oh oe okt tie ple de ole ole ote ofe he ote KOO GR ok dak kook oko ak sk koko kook ok ake ok ok ok aa ae ke ae fe ake 2k ake ake ae ake ake // 


/* rtc() - execute RTC examples * / 
(OCC ICO IO OC FO ICICI OK IO ICICI CIC GIGI CHS eke ak aok ak ae ak ak ak ak deck // 
rtc(} 


{ 
static MESSAGE mrtc[] = 
{ 


/* rtc menu */ 


tg 
Bo 
P= 


"Real-time Clock and CMOS Example" }, 
"F1. Display CMOS hardware setup" }, 


on 
nN 
od 


6, 24, "F2. Display CMOS checksum" }, 

7, 24, "F3. Display calculated CMOS checksum" }, 
8, 24, "F4. Set CMOS checksum" }, 

9, 24, "F5. Set date" }, 


BD 


"F6. Set time" }, 

"F7. Set day-of-week" }, 
"F10. Return to Main menu" }, 
sae 
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unsigned char tmp; /* to hold CMOS byte read */ 


unsigned char sum; 
char line[512]; 
int i; 

int r; 

DATIM dt; 

CMOS *pcmos; 


#Hdefine ROW 16 
#define COL 17 


pemos = 0; 
line[O] = Q; 
while(1) 

{ 


disp_menu(mrtc) ; 


switch(line[0]) 
{ 
case FI: 
sh_hdw() ; 


break; 


/* to hold calculated checksum 
/* to hold input line 

/* to hold menu selection 

/* temp value 

/* place to store date & time 
/* ptr to RTC/CMOS structure 


/* structure offset is zero 
/* null terminated 
/* forever (see F10) 


/* display the rtc menu 
/* determine menu selection 


/* show CMOS hardware 
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case F2: /* get current checksum */ 
sprintf(line, "CMOS checksum = {02x", 
rd_rtc(&pcmos~->cksum1)) ; 
disp_str(ROW, COL, line); 
break; 
case F3: /* calculate checksum */ 


sprintf(line, "Calculated checksum = %02x", rtc_cksum()) ; 
disp_str(ROW, COL, line); 
break; 


case 


sum = rtc_cksum(); 


F4: 
/* write calculated checksum */ 


wr_rtc(&pcmos->cksuml, sum) ; 
sprintf(line, "Checksum byte set to %02xH", sum) ; 
disp_str(ROW, COL, line); 


break; 

case FS: /* set new date * f 
while(1) 
{ 


disp_str(ROW , COL,"Enter date as MM/DD/YYYY") ; 


disp_str(ROW + 1, COL, "Where MM represents the month (1 - 12)") 
disp_str(ROW + 2, COL, "Where DD represents the day (1 - 31)"); 


disp_str(ROW + 3, COL, "Where YYYY represents the year (0000 - 
9999)") ; 

disp_str(ROW + 4, COL, "Date: "); 

get_keys(ROW + 4, COL + 6, line); 


r 


= gscanf(line, "%2d/%2d/%4da", &dt.month, 
&dt.dom, &dt.year); 


if(r '!= 3) continue; 

else break; 
} /* note: no limit check */ 
wr_rtc(&pcmos~>month, bcd(dt.month)) ; /* write month */ 
wr_rtc(&pcmos->dom, bcd(dt.dom)) ; /* write day-of-month */ 
wr_rtc(&pcmos->year, bcd(dt.year % 100)); /* write year */ 
wr_rtc(&pcemos->century, bcd(dt.year / 100)); /* write century */ 
rd_rtc(&pcmos->regd) ; /* make date valid, set the VRT bit */ 


shw_date(); 
disp_menu(mrtc) ; 
break; 


Case 


F6: /* set new time */ 


while(1) 


{ 


disp_str (ROW , COL, "Enter time as HH:MM:SS"); 


ee 
as 
aud 
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disp_str(ROW + 
disp_str(ROW + 
disp_str(ROW + 
disp_str(ROW + 4, COL, "Time: "); 
get_keys(ROW + 4, COL + 6, line); 


r = sscanf(line, "(%2d:%42d:%2d", &dt.hours, &dt.minutes, 


&gdt.seconds) : 


} 


wr_rtc(&pcmos->hours, bcd(dt.hours)); 

wr_rtc(&pcmos->minutes, bcd(dt.minutes) ); 
wr_rtc(&pcmos->seconds, bcd(dt.seconds)) ; 
rd_rtc(&pcmos->regd) ; /* make time valid, set the VRT bit > 


if(r != 3) continue: 
else break; 


/* note: no limit check * 

/* write hours 
/* write minutes * 
/* write seconds * 


shw_time(); 
disp_menu(mrtc) ; 
break: 


case F7: 
while(1) 


{ 


disp_str(ROW, COL, "Enter day~of-week (1 ~- 7): "); 
get_keys(ROW, COL + 27, line); 

r= sscanf(line, "4d", &dt.dow); 

if(r != 1) continue; 

else break; 


(Oo - 
(0 - 


} /* note: no limit check 
wr_rtc(&pcmos->dow, bcd(dt.dow)) ; /* write day-of-week 


rd_rtc(&pcmos~>regd) ; 


shw_date() ; 
disp_menu(mrtc) ; 


/* make DOW valid, set the VRT bit * 


1, COL, "Where HH represents the hour (0 - 23)"); 
2, COL, "Where MM represents the minutes 
3, COL, "Where SS represents the seconds 
4 


59)") ; 
59)""); 


* f 
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break; 
case F10: /* return to caller (main menu) */ 
return; 
} 
line[O] = get_fkey(); /* get a function key for menu selection */ 
} 
} 
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Chapter 6 
Three-Channel Counter 
and Speaker 


Overview 


The VAXmate processor board has an 8254 programmable interval timer that 
provides three independent 16-bit counters for counting or timing. All three 
counters have a 1.1931816 MHz clock input. The counters are programmable 
and are used by the ROM BIOS as follows: 

¢ Counter 0 is a general purpose timer to provide: 


A time-of-day clock 
- A diskette drive motor timer 
- A screen blanking timer 


Its output goes to IRQO of the interrupt logic. 
CAUTION: Reprogramming this counter can destroy the timing. 

¢ Counter 1 provides the dynamic RAM refresh timing. The ROM BIOS 
programs it for a 15 us cycle time. Its output is connected to the refresh 
counter. 
CAUTION: Reprogramming this counter can destroy the refresh cycle. 


Counter 2 provides a frequency-modulated square wave output for the 
speaker interface. 


Additional Source of Information 


The following Intel Corporation document provides additional information on 
ad the 8254 three-channel counter/timer. 


¢ Microsystems Components Handbook (Publication Number 230843) 


Three-Channel Counter and Speaker - Hardware Description G- 1 


Block Diagram 

Figure 6-1 shows the block diagram of an 8254. The data bus bu 
the I/O data bus, and the read/write logic interfaces the address | 
CPU module. 
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Figure 6-1 Three-Channel Counter/Timer Block Diagram 


Counter Description 


The three 16-bit synchronous down counters are identical in operation, but fully 
independent. Each counter has two 8-bit input latches (count registers), two 8- 
bit output latches, and a counting element. The counter control logic enables 
only one latch at a time. Therefore, writing a 16-bit count requires two 8-bit 
writes to the same register and reading a 16-bit count requires two 8-bit reads 


The control word register provides for 8-bit and 16-bit counts. The 8-bit count 
can be written to either the least significant byte (LSB) or the most significant 
byte (MSB). Loading one 8-bit count register of a 16-bit pair clears the other 
count register. That is, writing an 8-bit count to the LSB clears the MSB and 


writing an 8-bit count to the MSB clears the LSB. 
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CPU module. A 14.31818 MHz signal divided by 12 provides a 1.1931816 MHz 
clock to all three counters. 


A high level (1) at the GATE input enables counting and a low level (0) at the 
GATE input disables counting. 


tion of the OUT signal. 


Table 6-1 Counter Signals 


Counter CLK Frequency GATE Source OUT Destination 
0 1.1931816 MHz Tied high IRQO 

1 1.1931816 MHz Tied high Refresh timer 

2 1.1931816 MHz System CSR (bit 0) Speaker driver 
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Mode Definitions 
The three-channel counter/timer has six modes of operation: 


atl Mode 0 Interrupt on Terminal Count 
Mode 1 Hardware Retriggerable One-Shot (not used) 
Mode 2 Rate Generator 
Mode 3 Square Wave Mode 
Mode 4 _— Software Triggered Strobe 
Mode 5 _—_— Hardware Triggered Strobe (retriggerable) 


Table 6-2 lists the default mode and function of each counter in the VAXmate 
workstation (as established by the ROM BIOS). 


Table 6-2 Modes Used by the Three Counters 
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Counter Function Mode Description Output 
0 Time-of-day clock 5 Hardware trig- IRQO 
gered strobe 
1 Refresh timing 2 Rate generator Refresh counter 
2 Speaker waveform 3 Square wave Speaker driver 
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Mode 0 (Interrupt on Terminal Count) 


Mode 0 is used for one-shot event counting. 


Initializing Mode 0 
Programming: the control word for mode 0 causes OUT to go low. The GATE 
input has no effect on the OUT signal. 


If a new count is written during counting, the new count is loaded on the next 
CLK pulse and counting continues from the new count. 


Mode 0 Cycle 

Writing a new count starts the cycle. Where n equals the count, the mode 0 
cycle is n + 1 CLK pulses long. During the start of the cycle, the OUT signal 
is low for n CLK pulses (while the counter decrements from n to 0.) On the 
next CLK pulse, the OUT signal makes a transition from low-to-high. The OUT 
signal remains high until the control word is written or until a new count is 
written. 


Mode 1 (Hardware Retriggerable One-Shot) 


Mode 1 is used for one-shot event counting. Because the GATE input is the 
trigger, mode 1 is viable only on counter 2 (the GATE input of counters 0 and 
1 are tied high.) Mode 1 could be used for sound generation, but it is not nor- 
mally used on the VAXmate workstation. 


Initializing Mode 1 

Programming the control word for mode 1 and writing a new count causes 
OUT to go high and arms the trigger. The GATE input has no effect on the 
OUT signal. 


Writing a new count during counting has no effect on the current count. 
However, if the GATE input is triggered, the cycle restarts with the new count. 


Mode 1 Cycle 

With the trigger armed, a low-to-high transition at the GATE input triggers 
the cycle. On the next CLK pulse, the count is loaded and the OUT signal 
makes a high-to-low transition. Where n equals the count, the OUT signal re- 
mains low for n CLK pulses. That is, when the count decrements to 0, the 
OUT signal goes high. 


After the trigger is armed for the first time, the trigger remains armed until 


the control word is reprogrammed. Thus, after a count has decremented to 0, 
triggering the GATE input restarts the cycle. The count is reloaded 
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automatically. 


Triggering the GATE input before a count decrements to 0 restarts the cycle 
on the next CLK pulse. The count is reloaded automatically. Because the count 
did not expire, the OUT signal remains low. 


Mode 2 (Rate Generator) 


Where n equals the initial count, mode 2 functions like a divide by n counter. 
It generates pulses at a rate equal to the input frequency divided by the initial 
count (n). Mode 2 is periodic, repeating the cycle every n CLK pulses. 


The ROM BIOS uses counter 1 in mode 2 to provide the refresh timing signal. 


Initializing Mode 2 

Programming the control word for mode 2 causes OUT to go high. Providing 
that the GATE input is high, the cycle starts 1 CLK pulse after the initial 
count is written. 


If the GATE input goes low, the OUT signal goes high immediately. On the 


reloads the initial count. Thus, the GATE input can synchronize the count to 
an external event. 


Writing a new count during counting has no effect on the. count for the current 
cycle. When the cycle repeats, the count is reloaded with the new count. 
However, if the GATE input is triggered, the new count is loaded on the next 
CLK pulse and cycle restarts. 


Mode 2 Cycle 

Where 7 is the initial count, the mode 2 cycle is n CLK pulses long. During 
the start of the cycle, the OUT signal is high. The OUT signal remains high 
until the count decrements to 1. When the count decrements to 1, the OUT 
signal makes a high-to-low transition and the counter reloads the initial count. 
The OUT signal is low only for that CLK pulse. On the next CLK pulse, the 
OUT signal goes high and the cycle repeats. 


NOTE 
In mode 2, a count of 1 is invalid. 


Mode 3 (Square Wave Mode) 


Mode 3 generates a square wave at the OUT signal. Where n is the count, the 
OUT signal has a frequency equal to CLK / n. When nis an even number, the 
OUT signal is high for n / 2 CLK pulses and then low for n / 2 CLK pulses. 
When n is an odd number, the OUT signal is high for (n + 1) / 2 CLK pulses 
and then low for (n - 1) / 2 CLK pulses. 
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Initializing Mode 3 

Programming the control word for mode 3 causes OUT to go high, Providing 
that the GATE input is high, the cycle starts 1 clock pulse after the initial 
count is written. 


aw 


If the GATE input goes low, the OUT signal goes high immediately. On the 
CLK pulse following a low-to-high transition at the GATE input, the counter 
reloads the initial count. Thus, the GATE input can synchronize the count to 
an external event. 


Writing a new count during counting has no effect on the count for the current 
cycle. When the cycle repeats, the count is reloaded with the new count. 
However, if the GATE input is triggered, the new count is loaded on the next 
CLK pulse and cycle restarts. 


Mode 3 Cycle 
In the first CLK pulse, the initial count is loaded. If the count is odd, then 
count - 1 is loaded. The cycle starts with the next CLK pulse. 


With each succeeding CLK pulse, the count is decremented by two. When the 
count decrements to 0, the initial count is tested for an odd or even value. If 
the initial count was even, the OUT signal makes an immediate transition from 
high-to-low. If the initial count was odd, the counter waits one more CLK pulse 
and then makes a high-to-low transition. The initial count is reloaded and dec- 
remented by two, which starts the second half of the cycle. With each succeed- 
ing CLK pulse, the count is decremented by two. When the count decrements 
to 0, the OUT signal makes an immediate transition from low-to-high; the in- 
itial count is reloaded and decremented by two, which starts a new cycle. 


Mode 4 (Software Triggered Strobe) 

In mode 4, the count cycle is triggered by writing a new count. Where n equals 
the initial count, the OUT signal is high for n + 1 CLK pulses, low for 1 CLK 
pulse, and then high until a new count is written. 


Initializing Mode 4 
Programming the control word for mode 4 causes OUT to go high. The GATE 
input has no effect on the OUT signal. 


If a new count is written during counting, the new count is loaded on the next 
CLK pulse and counting continues from the new count. 


For a 2-byte count, writing the first byte has no effect on counting. Writing the 
second byte allows the count to be loaded on the next CLK pulse. 


Writing a new count while the original count is counting allows the new count 
to be loaded on the next CLK pulse. 
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Mode 4 Cycle 

The mode 4 cycle is triggered by writing a new count. The new count is loaded 
on the next CLK pulse, but not decremented. With each successive CLK pulse, 
the count is decremented. When the count decrements to 0, the OUT signal 
goes low. It remains low for 1 CLK pulse. When the count decrements to 
FFFFH, the OUT signal goes high. Until a new count is written, the OUT 
signal remains high, which restarts the cycle. 


Mode 5 (Hardware Triggered Strobe) 


Because the GATE input is the trigger, mode 5 is viable only on counter 2 (the 
GATE input of counters 0 and 1 are tied high.) Where 7 equals the initial 
count, the OUT signal is high for n + 1 CLK pulses, low for 1 CLK pulse, 
and then high until the GATE input triggers another cycle. 


Initializing Mode 5 

Programming the control word for mode 1 and writing a new count causes 
OUT to go high and arms the trigger. The GATE input has no effect on the 
OUT signal. 


However, if the GATE input is triggered, the cycle restarts with the new count. 


Mode 5 Cycle 

the cycle. The new count is loaded on the next CLK pulse, but not decre- 
mented. With each successive CLK pulse, the count is decremented. When the 
count decrements to 0, the OUT signal goes low. It remains low for 1 CLK 
pulse. When the count decrements to FFFFH, the QUT signal goes high. 


After the trigger is armed for the first time, the trigger remains armed until 
the control word is reprogrammed. Thus, after a count has decremented to 0, 
triggering the GATE input restarts the cycle. 


Triggering the GATE input before a count decrements to 0 restarts the cycle 
on the next CLK pulse. The count is reloaded automatically. Because the count 
did not expire, the OUT signal remains high. 
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Registers 


This section discusses the 8254 registers. Because bit 0 controls the GATE 
input of counter 2 and bit 1 controls the output to the speaker, the system 
register is also discussed here. Table 6-3 shows the addresses of the 8254 regis- 
ters and the system register. 


Table 6-3 8254 and System Register Addresses 


iinet ememnareenson Hea 


einen iinet 


5st 
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Register R/W Address 
8254 - Counter 0 R/W 0040H 
8254 - Counter 1 R/W 0041H 
8254 - Counter 2 R/W 0042H 
8254 - Command Word W 0043H 
System R/W 0061H 
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o Ne 


System Register (0061 H) 
7 6 5 4 3 2 1 0 


eno satan mantis te 


| COUNTER | REFRESH | ENABLE | ED 


Bit R/W_ Description 


“eonmenonoiesaesn ernest ohare eM enue 
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7 R RAM PARITY CHECK 
0 = Processor board RAM parity good 
1 = Processor board RAM parity error 
WwW Always 0 
6 R VO CHECK 
0 = No bus I/O error or option RAM parity error 
1 = Bus I/O or option RAM parity error exists 
Ww Always 0 
COUNTER 2 OUT SIGNAL 
Q = Counter 2 OUT signal is low 
1 = Counter 2 OUT signal is high 
Ww Always 0 
4 R REFRESH REQUEST 
0 = Refresh request not active 
1 = Refresh request active 


setter een erent in smerny ee eH Her aH 


Col 


The diagnostic software uses this bit to check the operation of the 
DRAM refresh circuitry. 
WwW Always 0 
3 R/W ENABLE I/O CHECK 
0 = Enables checking of the bus I/O check line and option RAM 
parity (enabled by ROM BIOS) 
1 = Disable bus I/O error checking 
R/W ENABLE RAM PARITY CHECK 
(} = Enable processor board RAM parity checking (enabled by 
ROM BIOS) 
1 = Disable processor board RAM parity checking 


nN 
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Bit R/W_ Description (System Register - cont.) 
1 R/W SPEAKER DATA 
0 = No sound output from speaker a | 
1 = Sound output from speaker (Counter 2 OUT signal must be 
high or generating a frequency) 


The output of this bit is ANDed with the Counter 2 OUT 
SIGNAL. Assuming that the counter 2 OUT signal is high, tog- 
gling this bit generates a pulse train to the speaker driver. 
Otherwise, to enable sound output to the speaker, this bit must 
equal 1. 

0 R/W COUNTER 2 GATE INPUT 
Q = Counter 2 GATE input is low 
1 = Counter 2 GATE input is high 
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Control Word Register (0043H) 
7 6 5 4 3 2 1 0 
— arent to 


SELECT 
COUNTER. 


MODE 
SELECT 
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Bit R/W_ Description 
7-6 W SELECT COUNTER 
00 = Select counter 0 
01 = Select counter 1 
10 =~ Select counter 2 
11 =  Read-back command 


5-4 W READ/WRITE 
00 = Counter-latch command 
01 = # Read/Write LSB 
10 = Read/Write MSB 
11 = Read/Write LSB first, then MSB * 


3-1 W MODE SELECT 

Nasi 000 = Mode 0 
001 = Mode 1 

X10 = Mode 2 

X11 = Mode 3 

100 = Mode 4 

101 = Mode 5 


0 WwW BINARY CODED DECIMAL 
Q = Binary counter 16 bits 
1 =  Binary-coded-decimal (BCD) counter (4 decades) 
* The counter does not start counting until the second byte of the 2-byte 
pair is written to the counter latch. 
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Counter-Latch Command (Control Word Register) 

7 6 5 4 3 2 1 0 
SELECT 
COUNTER 

Soe tera  Eaeeenerree 


Bit R/W_ Description 

7-6 W SELECT COUNTER 
00 = Select Counter 0 
01 = Select Counter 1 
10 = Select Counter 2 
11 = #£=Undefined 


nie niieusonsenessiniinistnnisins inant recta ee ts sess tama eesti 


o-0 W Always 0 for counter-latch command 


Counter-latch commands do not affect the programmed mode of the counter. 
The counter-latch command latches the contents of the counters without affect- 
ing the count in progress, When the 8254 receives a counter-latch command, it 
latches the selected counter into the counters output latch. The latched count 
is held until read by the CPU (or until the counter is reprogrammed). After the 
latched count is read, the output latch follows the count in the counter. 


When a counter-latch command is issued for more than one counter, each 
counter output latch holds the count until read. When any given counter is 
latched two or more times without an intervening read, only the first latch 
command is effective. When read, the count is the count latched by the first 
counter-latch command. 


The latched count must be read according to the programmed format (LSB, 
MSB, or LSB and MSB). 
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Read-Back Command (Control Word Register) 


7 6 > 4 2 2 1 0 


Bit R/W_ Description 


“vioamonomnesmaennonnnatsnmetonestnneetionannedameniannanenrnennonetinenannynssunment 


7-6 W Always 11 


5-4 W LATCH COUNT and LATCH STATUS 
00 = Latch status and count of selected counter(s) 
Ol = Latch count of selected counter(s) 
10 = Latch status of selected counter(s) 
11 = Undefined 

3 W COUNTER 2 SELECT 
0 = Counter 2 not selected 
1 = Counter 2 selected 

2 WwW COUNTER 1 SELECT 
Q = Counter | not selected 
1 = Counter 1 selected 

1 WwW COUNTER 0 SELECT 
0 = Counter 0 not selected 
1 = Counter 0 selected 


0 Ww Always 0 
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The read-back command is written to the control word register. For the se- 
lected counters, the read-back command latches a status byte and/or the cur- 
rent count. 


The status byte format is described under Status Response. The status byte is 
read from the indicated counter register as a single 8-bit byte. When the read- 
back command latches both status and count, the status byte is read first and 
then the count. Thereafter, any read returns an unlatched count. 


The latched count follows the format described under Counter-Latch Command. 
If multiple read-back commands are issued without intervening reads, all but 
the first are ignored. The status read is the status at the time of the first 


read-back command. 
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Status Response (Read-back Command) 
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Three-Channel Counter and Speaker 


UT PIN 
= OUT pin is high (1 
0 = OUT pin is low (0) 


NULL COUNT 


~~ 


1 


r 


Null count 


SELECTED 
MODE 


2 1 0) 


agin ieee eID AN ey nh Io Neen einen operant lev nt SRA DRIER evecare MM: 


) = New count is loaded and is available for reading. 


A write to the control word register has occurred, which sets the 
null count bit of specified counter. If the counter is programmed 
for 2-byte counts, when the second byte is written, the null count 


poes to l. 


READ/WRITE 

00 = Counter-latch command 
Ol = Read/Write LSB 

10 = Read/Write MSB 


11 = #£Read/Write LSB first, then MSB. 


SELE iC TED MODE 
000 = Mode 0 
001 = =Mode 1 
X10 = Mode 2 
All = Mode 3 
100 = Mode 4 
101 = Mode 5 


BINARY CODED DECIMAL 
Q = Binary counter 16 bits 


1 =  Binary-coded-decimal (BCD) counter 
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- Hardware Description 


This page is intentionally blank. 
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Programming Example 


The three channel counter/timer and speaker programming example 
demonstrates: 


e Writing the counter/timer registers 
e Enabling and disabling the output to the speaker 


e Setting the output frequency to the speaker 


The example provides routines as described in the following list: 


wr_cntl6 Writes a 16-bit value to the indicated counter 

beep Enables the bell (beep) at the speaker 

unbeep Disables the bell (beep) at the speaker 

tim_ spk Initializes the counter, displays the menu, and executes the ex- 


ample program 


CAUTION 

Improper programming: or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


Constant Values 
The included file kyb.h defines constant values for function keys. For informa- 


tion about keyboard programming, see Chapter 8. For a listing of the file 
kyb.h, see Appendix A. 


The included file example.h defines the structure type MESSAGE that is used 
to display the menu. For a listing of the file example.h, see Appendix A. 


The constant value systat defines the offset of the system status register in 
I/O space. 


The constant values cwrdreg through count2 define the offset of the 8254 


The constant values selent0 through rbcnt2 define the bit values of various 
8254 counter/timer commands. 

The constant value inpfreq defines the input frequency to all three counter/ 
timers. 
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#include "kyb.h" 
#include "example.h" 


/* reference function key constants 
/* reference menu structure 


*/ 
*/ 


JOO ok IR doko kk dod iokokok dodo dod doko ok sk ok fea aa fe ae ae ake ake ake ake ake ake // 


/* define constants used to program 8254 timer 
JRO ko ok kok kok OG iO a ak kook ok ok ok ake ok ok ak kc ok ake ake feo ake okt a ok ok fe a ake akc ake ake afc ake ake ake ake ake / 


#define 


#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 


#define 
#define 
#define 
#define 
#define 


#define 


SYSTAT 


CWRDREG 
COUNTO 
COUNT1 
COUNT2 


SELCNTO 
SELCNT1 
SELCNT2 
SELRDBK 


LATCOM 
RWLSB 
RWMSB 
RWLSMS 


TMODEO 
TMODE1 
TMODE2 
TMODES3 
TMODE4 
TMODES 


BINDAT 
BCDDAT 


LATCNT 
LATSTA 
RBCNTO 
RBCNT1L 
RBCNT2 


INPFREQ 11931811 
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Ox61 


0x43 
0x40 
Ox41 
Ox42 


0x00 
0x40 
0x80 
OxCO 


0x00 
0x10 
0x20 
0x30 


0x00 
0x02 
0x04 
0x06 
0x08 
0x09 


0x00 
OxO01 


0x20 
0x10 
0x02 
0x04 
0x08 


/* system status register in I/0 space 


/* control word register in I/O space 
/* counter O register in I/0 space 
/* counter 1 register in I/0 space 


/* counter 2 register in I/O space » 


/* select counter 0 
/* select counter 1 
/* select counter 2 
/* select read back 


/* select latch command 

/* read/write LSB 

/* read/write MSB 

/* read/write LSB then MSB 


/* select timer mode 
/* select timer mode 
/* select timer mode 
/* select timer mode 
/* select timer mode 
/* select timer mode 


mom GNF © 


/* binary count data 
/* binary coded decimal count data 


/* read back cmd latch count 
/* read back cmd latch status 
/* read back counter 0 


/* read back counter 1 * 


/* read back counter 2 


/* 14.31818 Mhz / 12 = 1,.1931816 Mhz -: 


*/ 


*/ 


17 
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Writing a Counter 


The function wr_cnuti6 writes a 16-bit value to the indicated counter. A 16-bit 
value is written 8-bits at a time (low byte first) to the same port. 


Making a Bell Sound 

The function beep enables the speaker output at 1000 Hz. It provides the bell 
(beep sound) for the ASCII character BEL (07H). This function can be called at 
any time. The speaker output is automatically disabled by the function unbeep. 


The function unbeep monitors the variable beep flag. If required, it disables the 
speaker. This function is called from within the real time clock interrupt han- 
dler. It tracks the number of 125 ms periods that the speaker has been on for 
a bell (beep sound). After 500 ms total, the speaker output is disabled. If the 
real time clock interrupts are not enabled, the speaker output will not be 
disabled automatically. 
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JOC Co OI OO GG io I fok kok GI kok ok kk a ok ake ak a ak coke ake ake ae tak ake / 


/* wrocnti6() - write 16-bit value to counter * / 
{ROR oo doko oiokokdo a kk ak ok kd de gk ok ke doa ok oi sk ok ak kk a ok ok ake ode ok 2k ok eke ake ake ake ok aie ae ae ake ake akc ake ake ae ate ae ake / 


wr_cnti6(counter, value) 


unsigned char counter; /* which counter to set */ 
unsigned int value; /* 16-bit value */ 
unsigned int intr_flag; /* to hold current IF state */ 
intr_flag = int_offQ; /* disable interrupts */ 
outp(counter | COUNTO, value & Oxff); /* write counter low byte */ 
outp(counter | COUNTO, value >> 8); /* write counter high byte */ 
int_on(intr_flag) ; /* enable interrupts */ 
} 
JOS IGOR ISCO IOI GORI IOI GOI II II I I sk ak kee ak ak / 
/* beep() - start up beep sound at speaker * | 
[COI IIR IOUS IOI ICRC ICICI IOI IOI ICI ICI IOI RACH kk ak ake dete / 
int beep_flag; /* true while beeping */ 
beep () 
a! 
wr_cnt16(2, (int) CINPFREQ / 1000L)); /* set desired frequency */ 
outp(SYSTAT, 0x03) ; /* turn speaker on */ 
beep_flag = 1; /* set flag, speaker is on */ 
} 
[SCO IO ICO CIO IGOR OIC IGG IGG kk iG k ok kok gdok ak doi kick ak ak ac dokok ek ak ak kkk / 
/* unbeep() - time to stop beep sound at speaker 7? */ 


[CROCCO OOOO ORO OGG OG I a i ged tok dees / 


unbeep() 
{ 
if (beep_flag) /* are we making a beep sound */ 
if (++beep_flag > 3) /* has it been on long enough */ 
{ 
outp(SYSTAT, 0x00); /* turn it off +/ 
beep_flag = 0; /* reset flag */ 
} 
: 
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Counter and Speaker Example 


The function tim_spk initializes the counter, displays the menu, and executes 
the example. 


/* tim_spk() - execute timer and speaker examples * f 


tim_spk() 

4 

static MESSAGE mtim_spk[] = /* menu for timer/speaker example */ 
{ 

3, 24, "8254 Timer and Speaker Example" }, 
9, 24, "F1. Set frequency to speaker" }, 
6, 24, "F2. Speaker on" }, 

24, "F3. Speaker off" }, 

, 24, "F4. DO-RE-MI" }, 

9, 24, "FiO. Return to Main menu" }, 

Oo, 0, Of}, 


Soo a~s A OM & 


sae 


static int tone[8] = /* frequencies for notes to do-re-mi */ 
{ 2281, 2032, 1810, 1709, 1524, 1366, 1209, 1140 }.; 


char line[512]; /* to hold input line */ 
unsigned int freq; /* to remember frequency */ 
unsigned int tval; /* general temporary */ 
unsigned int 1; /* iteration control */ 
extern unsigned int metronome; /* defined in clock example */ 


/* maintains beat of do-re-mi */ 
#define ROW 16 
#define COL 17 


line[O] = 0; 
freq = 1000; /* default, frequency */ 
/* initialize counter mode */ 
outp(CWRDREG, SELCNT2 | RWLSMS | TMODE3 | BINDAT); 
while(1) 
( 
disp_menu(mtim_spk) ; 
switch(line[0]) 
‘ 
case Fl: /* set output frequency */ 
disp_str(ROW, COL, "Enter new frequency (19Hz - 20000Hz):"); 
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get_keys(ROW, COL + 37, line); 
sscanf(line, "4d", &freq) ; 

if(freq < 18) freq = 19; 

else if(freq > 20000) freq = 20000; 
tval = (int) (INPFREQ / (long) freq) ; 


disp_menu(mtim_spk) ; 


break; 
case F2: /* turn speaker on */ 
outp(SYSTAT, 0x03) ; 
break; 
case F3: /* turn speaker off */ 
outp(SYSTAT, Qx00) ; 
break; 
case F4: /* play do-re-mi */ 
i=0; /* iteration count = 0 */ 
metronome = Oxffff; /* prepare counter to overflow */ 
while(metronome) ; /* wait until it overflows */ 
wr_cnti6(2, tone[lit++]); /* start first note */ 
ai outp(SYSTAT, 0x03) ; /* enable speaker */ 
while(i < 9) /* do all notes */ 
{ 
if (metronome > 3) /* hold note for 500 ms */ 
{ 
wr_cnti6(2, tone[it+]); /* next note */ 
metronome = Q; /* reset counter */ 
} 
chk_dt(Q); /* redisplay time for menu ? */ 
} 
outp(SYSTAT, 0x00); /* turn speaker off */ 
tval = (int) (INPFREQ / (long)freq); /* reset frequency */ 
wr_cnt16(2, tval); 
break; 
case F10: /* return to caller */ 
return; 
} 
line([O] = get_fkey(); /* get function key */ 
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Chapter 7 
Video Controller 


: ° 
Introduction 

The VAXmate video controller is on the I/O board and drives a monochrome 
monitor. The video controller can process 16 colors or shades of gray. In this 
chapter, the term color also means shades of gray or intensity levels. 


Industry-Standard Text and Graphics Features 
The VAXmate video controller has the following industry-standard text and 
graphics features: 


80 x 25 and 40 x 25 text display 


ee 
° 8 x 8 graphics character cell 
° character attributes: 

- 16 foreground colors 

- 16 background colors or 8 background colors plus blink 
* bit map graphics with industry-standard color palettes 

- 320 x 200 4 colors 

- 640 x 200 2 colors 
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Enhancements to Industry-Standard Features 


The video controller has the following enhancements to industry-standard 


features: 


The screen resolution is 640 horizontal pixels by 400 scan lines. 
Industry-standard graphics (200 scan lines) is accomplished by 
displaying each scan line twice. 


The character pattern is 8 horizontal pixels by 16 scan lines, result- 
ing in higher quality characters in text modes. 

The 256-character font RAM provides flexibility in terminal emula- 
tion and multilingual applications. 


The dual-port video memory eliminates annoying screen flicker (dis- 
abling the screen before accessing video memory is unnecessary). 


The 16-bit data path to video memory, coupled with the dual-port 
access results in faster screen updates. 


Industry-Standard Features Not Available 


The video controller does not support these features: 


e @ @ «@ 


160 x 100 16-color graphics mode 
15.75 KHz monitor support 
Border color support 

Light pen support 


Extra Features 


The video controller has the following additional graphic features: 


sa 


# @# 2 & 


640 x 400 2-color graphics 
640 x 400 4-color graphics 
640 x 200 4-color graphics 
800 x 252 4-color graphics 
320 x 200 16-color graphics 
256-character soft font 
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1 f * 
Block Diagram 
The video controller consists of a display processor and video memory that 
reside on the I/O board. As shown in Figure 7-1, the display processor includes 
a translation ROM, a 6845 CRT controller, text video logic, graphics video 
logic, a video look-up table, and status and control registers. 
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Figure 7-1 Block Diagram of the VAXmate Video Controller 


The translation ROM translates industry-standard color graphic adapter data to 
data that is correct for the DIGITAL video controller. 


The 6845 CRT Controller (CRTC) internal registers control horizontal and ver- 
tical positioning, synchronization, video and cursor starting addresses, and 
width of video display. 


Two status registers monitor vertical synchronization, video blanking time, and 
various modes in the control registers. 


The two control registers enable the various text and graphics modes. enable 
and disable the display, select the font RAM, select the video look-up table 
(VLT), and provide screen saver support. 
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64K bytes of dual-ported memory, which maps into the address space of the 
VAXmate CPU. 


The display processor converts memory data into various raster formats. The 
display processor generates IRGB outputs that drive the monochrome monitor. 
The VAXmate monitor displays the color information as different levels of in- 
tensity (shades of gray). 


Additional Sources of Information 


The following documents provide additional information on the video controller: 


Device Company Document 
6845-1 Motorola 8-Bit Microprocessor & Peripheral Data 


sume eee nwa sn omnneinene 


HD46505S — Hitachi 8/16-Bit Multi-Chip Microcomputer Data Book 
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Video Modes 


The video controller has several modes, some of which have a mode number 
assigned indicating that the ROM BIOS supports these modes. For modes not 
supported by the ROM BIOS, the hardware must be programmed directly. 
Table 7-1 shows the available video modes. 


For industry-standard color graphic adapters, the difference between a color 
and a monochrome mode is the presence (color) or absence (monochrome) of the 
color burst signal in the composite video output. Because the VAXmate video 
controller does not provide a composite video output, there is no difference be- 
tween the color and the monochrome modes. 


On powerup or system reset, the video system is initialized to mode 03H. 


Table 7-1 Available Video Modes 


* 7 , op, a wee : 
Mode Size Description 


OOH 40x 25 text mode monochrome (industry-standard} 
O1H 40x 25 text mode color (industry-standard) 
02h 80x 25 text mode monochrome (industry-standard) 
03h 80x 25 Text mode color (industry-standard) 


04H 320 x 200 4-color graphics mode (industry-standard) 
05h 320 x 200 monochrome graphics (industry-standard) 

06h 640 x 200 monochrome graphics mode (industry-standard) 
- 320 x 200 16-color graphics mode (digital extended) * 
dOh 640 x 400 2-color graphics mode (digital extended) 

dih 640 x 400 4-color graphics mode (digital extended) 

d2h 800x252 4-color graphics mode (digital extended) ** 

- 640 x 200  4-color graphics mode (DIGITAL extended) * 
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No ROM BIOS support 
** Limited ROM BIOS support 
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Text Modes 


The video controller has a 16 Kbyte text buffer in the address range B8000H- 
BBFFFH. Video modes 00H, 01H, 02H, and 03H use the text buffer. 

For modes 00H and 01H, the text buffer provides 8 display pages of 2048 
bytes each. For modes 02H and 03H, the text buffer provides 4 display pages 
of 4096 bytes each. 


Character Buffer Format 


A displayed character is represented by two consecutive bytes. The first byte, 
of the 2-byte pair, is the character code. The character code is stored at an 
even address. The second byte, of the 2-byte pair, is the attribute byte. The 
attribute byte is stored at the odd address following the character code. Figure 
7-2 shows the character code and attribute byte addressing. Table 7-2 defines 
the meaning of each bit within the attribute byte. 


B8000H B8001H B8002H B8003H - - +.» +. + + BBFFEH BBFFFH 


Even 
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Even 


Char 
Code 


q os esasusison encase enamine ert tment 


Figure 7-2 Character Buffer Format 


Table 7-2 Attribute Byte Bit Definitions 
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Bit Symbol Definition 


| Ib Background intensity / Blink * 

6 Rb Red contribution to background color 

5 Gb Green contribution to background color 
4 Bb Blue contribution to background color 
3 If Foreground intensity 

Ha Rf Red contribution to foreground color 

1 if Green contribution to foreground color 
0 Bf Blue contribution to foreground color 


eat 
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* The selection of background intensity or blink is determined by bit 7 of 
control register A. Control register A is described later in this chapter. 
When blink is enabled, the blink frequency is 1.9 Hz. 
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Character Position to Memory Location Mapping 


Character positions on the screen are identified as row (vertical) and column 
(horizontal) locations. The first character is displayed in the upper-left corner of 
the screen. which is location 0,0. To translate between screen positions and the 
address within the text buffer, use the following formula: 


Character code address = start address + (row * 2 * Y) + (column * 2) 


Attribute address = Character code address + 1 


Where: 
start address = Display page start address (see Table 7-3} 
row = 0 to 24 
column = 0 to 79 (80 X 25 modes) 
0 to 39 (40 X 25 modes) 


y= 80 (80 X 25 modes} 
40 (40 X 25 modes) 


In text modes, the video processor supports multiple display pages. For direct 
programming, registers R12 and R13 (described later in this chapter) control 
the display-page start address. Each displayed character requires 2 bytes (char- 
acter code and attribute byte). Therefore, the 80 x 25 modes require 4000 
bytes (80 x 25 x 2) and the 40 x 25 modes require 2000 bytes 

(40 x 25 x 2). The ROM BIOS also supports multiple display pages and 


Table 7-3 shows the display page addresses as defined by the ROM BIOS. 
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Table 7-3 Text Mode Display Pages (ROM BIOS) 
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Address 80 x 25 40 x 25 


Display Page Display Page 
B8:000H (iti 
B8800H 1 
B9000H 1 2 
B9800H 3 
BAOOOH 2 
BA800H 5 
BBO00OH 3 6 
BB800H 7 


Programmable Cursor 


For text modes only, the video controller provides a programmable cursor blink 
rate and cursor block size. The cursor blink is determined by bits 6-5 of regis- 


the character at the cursor position. The cursor block size is controlled by bits 
4-0 of registers R10 and R11. Registers R10 and R11 are discussed later in 
this chapter. 
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"Nisa 


Programmable Character Generator (Font RAM) 


The video controller has a 4 Kbyte programmable font RAM. The font RAM 
can store patterns for 256 characters. Normally, the font RAM is accessible 
only to the video controller. That is, the font RAM is not mapped into the 
normal CPU address space. Accessing the font RAM requires that the video 
ter B (described later in this chapter) controls access to the font RAM. When 
bit 4 of control register B equals 1, access to the video text buffer is disabled 
and access to the font RAM is enabled. Only even text buffer addresses are 
connected to the font RAM. The text buffer to font RAM mapping appears as 
follows: 


Text Buffer Offset Font Ram Offset 


seni eam HGH WN eis Dhaene He eosin 


B8000H OOOOH (first byte of font RAM) 
B8001H 

B8002H 0001H (second byte of font RAM) 
B8003H 

B8004H 0002H (third byte of font RAM) 
B8005H 


scien ieee snot inept eS jenny nmap aN dso 


B9FFDH 
BOFFEH OFFFH (last byte of font RAM) 
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NOTE 


if 


any graphics video mode. 


A character pattern consists of 16 bytes of pixel information. Each byte repre- 
sents 8 consecutive pixels of a horizontal scan line for the character. The most 
significant bit (bit 7) corresponds to the left-most pixel (pixel 0). The least sig- 
nificant bit (bit 0) corresponds to pixel 7. Each byte of the character pattern is 
read or written to an even address. Thus, each character pattern requires 32 
bytes of address space and an entire 256-character font requires 8K bytes. To 
calculate the address of the first byte of a character pattern, use the following 
formula: 


Character pattern start address = B8000H + (character code * 32) 
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‘ al? : 
Graphics Mode 
Each pixel on the screen is mapped into a bit-field of the corresponding byte in 
the display buffer. The width of the bit-field can be of 1, 2 or 4 bits depending 
on whether a 2-color, 4-color, or 16-color format is chosen. 


Mapping the Display to Address 


The logical display consists of a rectangular array of 200, 252, or 400 scan 
lines of pixels. For 200 scan line mode, the hardware generates two physical 
scan lines for each logical scan line. Each scan line is represented by 

(M / 8) * n consecutive bytes, where: 


M = Number of pixels per scan line 

n = 1, for 1-bit per pixel (2-color display} 

n = 2, for 2-bits per pixel (4-color display) 
n = 4, for 4-bits per pixel (16-color display) 


The memory maps for various graphic formats are shown on the following 
pages. Each memory map shows two or more blocks of memory that refer to: 


(L MOD A= R 
Where: 
Lis the desired scan line 


P is the number of memory blocks for the current video mode 
Ris the remainder of the division L/ P 


The remainder, Ft, specifies the memory block for a particular scan line. 


~] 
= 
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320 x 200 4-Color Mode 

ROM BIOS Video Modes: 04H and 05H - Industry-Standard 

In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 


See Figure 7-3 for the memory organization. See Figure 7-4 for the pixel to 
bit-field map. 
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L = SCAN LINE O TO 199 
Figure 7-3. Memory Organization for 320 x 200 4-Color Mode 
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Figure 7-4 Pixel to Bit-Field Map for 4-Color Mode 
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320 x 200 16-Color Mode 
No ROM BIOS Support - DIGITAL Extended 


In 16-color mode, a single byte corresponds to 2 consecutive pixels on the 
screen with the most significant bit of the byte corresponding to the left of the 
screen. See Figure 7-5 for the memory organization. See Figure 7-6 for the 
pixel to bit-field map. 
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Figure 7-5 Memory Organization for 320 x 200 16-Color Mode 
7 6 . 4 3 2 1 0 
CB2 CB1 CBO | CB3 CB2 CB1 CBO 


a ee eee eens ees [ ee : 
LEFT PIXEL RIGHT PIXEL 


Figure 7-6 Pixel to Bit-Field Map for 16-Color Mode 
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640 x 200 2-Color Mode 
ROM BIOS Video Mode: 06H - Industry-Standard 


In 2-color mode, a single byte corresponds to 8 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-7 for the memory organization. See Figure 7-8 for the pixel to 
bit-field map. 
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Figure 7-7 Memory Organization for 640 x 200 2-Color Mode 
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Figure 7-8 Pixel to Bit-Field Map for 2-Color (Monochrome} Mode 
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640 x 200 4-Color Mode 
No ROM BIOS Support - DIGITAL Extended 


In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-9 for the memory organization. See Figure 7-10 for the pixel to 
bit-field map. 
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Figure 7-9 Memory Organization for 640 x 200 4-Color Mode 
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Figure 7-10 Pixel to Bit-Field Map for 4-Color Mode 
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640 x 400 2-Color Mode 
ROM BIOS Video Mode: DOH - DIGITAL Extended 


In 2-color mode, a single byte corresponds to 8 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
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Figure 7-11 Memory Organization for 
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Figure 7-12 Pixel to Bit-Field Map for 2-Color Mode 
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640 x 400 4-Color Mode 
ROM BIOS Video Mode: DIH - DIGITAL Extended 


In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-13 for the memory organization. See Figure 7-14 for the pixel to 
bit-field map. 
———--- 160 BYTES PER SCAN LINE ——————_—__—_____ 
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Figure 7-13. Memory Organization for 640 x 400 4-Color Mode 
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Figure 7-14 Pixel to Bit-Field Map for 4-Color Mode 


7- 16 Video Controller - Hardware Description 


800 x 252 4-Color Mode 


ROM BIOS Video Mode: D2H (Limited ROM BIOS Support) - DIGITAL 
Extended 


In 4-color mode, a single byte corresponds to 4 consecutive pixels on the screen 
with the most significant bit of the byte corresponding to the left of the screen. 
See Figure 7-15 for the memory organization. See Figure 7-16 for the pixel to 
bit-field map. 
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Figure 7-15 Memory Organization for 800 x 252 4-Color Mode 
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Figure 7-16 Pixel to Bit-Field Map for 4-Color Mode 
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Video Look-Up Table 


The video processor has a video look-up table (VLT) that translates attribute or 
graphic color data. The VLT is arranged as 16 words of IRGB output data. 
Each location corresponds to one of the 16 possible colors. When the video con- 
troller accesses video memory, the attributes or graphic data are used as an 
offset into the VLT. The contents of that location in the VLT are sent to the 
video output circuit. Because the VLT has only 16 entries, the VLT can alter 


For 2-color mode graphics (640 x 400 or 640 x 200), the foreground color (pixel 
equals 1) is determined by the color-select register bits 3-0. The background 
color (pixel equals 0) is determined by the contents of VLT entry 0. The color 
select register is described later in this chapter. 


Normally, the VLT is accessible only to the video controller. That is, the VLT 
is not mapped into the normal CPU address space. Accessing the VLT requires 
that the video mode be one of the text modes 00H, 01H, 02H, or 03H. Bit 2 of 
control register B (described later in this chapter) controls access to the VLT. 
When bit 2 of control register B equals 1, access to the video text buffer is 
disabled and access to the VLT is enabled. 


NOTE 
Only write access to the VLT is enabled. To read the VLT in- 
directly, program the video processor for 320 x 200 16-color 
mode. For each of the 16 possible colors (QOH-OFH): 

1. Write the same color value to each pixel. 


2. Wait until the display is inactive (register B bit 7 
equals 1) 


3. Disable CPU interrupts (CLI instruction) 
4. Wait until the display is active (register B bit 7 equals 0) 


5. Status register A bits 7-4 (IRGB) are equal to the con- 
tents of the VLT location specified by the color value. 


> 


Enable CPU interrupts (STI instruction) 
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Only even-text buffer addresses are connected to the VLT. The text buffer to 
VLT mapping appears as follows: 


Text VLT Text VLT 
Buffer Offset Buffer Offset 


Offset Offset 
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B8000H OOOOH | B8010H 0008H 
B8001H 1B8011H 
B8002H 0001H B8012H OOO9H 
B8003H 1 B8013H 
B8004H 0002H |B8014H OOOAH 
B8005H |B8015H 
B8006H 0003H |B8016H OOOBH 
B8007H |B8017H 
B8008H OOO4H |B8018H OOOCH 
B8009H |B8019H 
B8O00AH OOO5H | BBO1AH OOODH 
B800BH | B801BH 
B800CH OOO6H |B801CH OOOEH 
B800DH | B801DH 
B800EH 0007H | B801EH OOOFH 
B800FH | B801FH 
r Text mode attributes are referenced in the order IRGB, but the VLT ad- 


dressing and contents are referenced in the order RGBI. To calculate the offset 
accessed by any IRGB value, use the following bit values: 


Bit Value Attribute 

) I (Intensity) 
1 B (Blue) 

2 G (Green) 

3 R (Red) 
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Thus, a text attribute of intensified red (IRGB = CQOH) accesses location 09H 
of the 16 locations in the VLT. 


On power-up or system reset, the VLT is initialized to the values in Table 7-4. 
The VLT values defined in Table 7-4 support video modes 00H, 01H, 02H, 
03H, 04H, 05H, O6H and DOH. When changing from any of these modes to 
video mode D1H or D2H, initialize the VLT to the values defined in Table 7-5. 
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Table 7-4 Default VLT Contents 


Offset 
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0 
0 
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Intensity 


Black 0 
Gray i 
Blue Zz 
Light blue 3 
Green 4 
Light green 5 
Cyan 6 
White 14 
Red 8 
Light red 9 
Magenta 10 
Light magenta 11 
Brown 12 
Yellow 13 
Light cyan 7 


Intense white 15 
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Table 7-5 VLT Contents for Video Modes DLH and D2H 
Offset Contents Color Intensity 
A3 A2 Al AO D3 D2 Di DO 


smog monmerme tn 


Q Black 0) 
0 0 0 1 0) 1 QO 0 Green 

0 oO 1 9 1 0 OO QO Red 

. 4 | © O 1 4 L Light cyan 

0 i 0) 0 Not Used 
0 1 0) l Not Used 
0 1 1 0 Not Used 
0 1 1 1 Not Used 
1 0 0 0 Not Used 
Not Used 
0 1 0 Not Used 
0 it 1 Not Used 
i 0 () Not Used 
Not Used 
1 i () Not Used 
1 1 1 Not Used 
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Video System Registers 


Table 7-6 lists the video processor input/output (I/O) registers. 


Table 7-6 Video Processor I/O Registers 
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Addwess bidet RIW Register Name Compatibility 

03 DOH 4. 0 W CRTC Index Register DIGITAL Extended 
O3D1H 7-0 R/W CRTC Data Register DIGITAL Extended 
03D4H = 4-0 Ww CRTC Index Register Industry-Standard 
O03D5H = 7-0 R/W CRTC Data Register Industry-Standard 
O3D8H = 7-0 W Control Register A Industry-Standard 
03D9H ~~ 7-0 W ‘olor Select Register Industry-Standard 
03DAH_ 7-0 R Status Register A Industry-Standard 
03DDH_ 7-0 R Status Register B DIGITAL Extended 
O03DEH 7-0 R Write Data Register DIGITAL Extended 
O3DFH 7-0 W Control Register B DIGITAL Extended 
OC80H = 7-0 R/W Special els iad Register DIGITAL Extended 
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Special Purpose Register (OC80H) 
7 6 5 4 3 2 1 0 


wos 


WRITE 
| PROTECT 


| DISABLE | SPEED 
| COMM SELECT 


Bit R/W_ Description 
f R Write protect 
0 = Selected diskette drive is not write protected 
1 = Selected diskette drive is write protected 
6 R Track 0 
0 = Head of selected diskette drive is not at track 0 
1 = Head of selected diskette drive is at track 0 
5 R Index 
0 = Index hole not in position for selected diskette drive 
1 = Index hole in position for selected diskette drive 
4 R Speed Indicator 
0 = Modem control speed select asserted 
1 = Modem control speed select not asserted 
3 R/W_ Disable Video 
0 = Video controller disabled 
1 = Video controller enabled 
2 R/W Split Baud Rates 
0 = (Receive = Transmit = programmed) 
1 = (Receive = 1200) (Transmit = programmed) 


i R/W_ Disable Communications 
0 = Integral communications ports connected to I/O address 
space 
1 = Integral communications ports disconnected from I/O address 
space 


Q) R/W_ Speed Select 
0 = Speed select asserted 
1 = Speed select not asserted 
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The special purpose register is located at I/O address OC80H. When bit 3 
equals 0, the entire DIGITAL video system is disconnected from the memory 
and I/O address space. This allows the installation and use of industry-standard 
video adapters in the VAXmate workstation. 


If the ROM BIOS finds an industry-standard video adapter during the power- 
up sequence, the ROM BIOS clears bit 3 of the special purpose register. This 
allows the industry-standard video adapter to function without conflict. 
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CRTC Registers 


The CRT controller (CRTC) has two registers, the index and data registers, 
that are accessible in the CPU I/O space. Writing a value to the index register 
selects one of the 18 internal registers RO-R17. The selected register is read or 
written through the data register. 


Index Register (0O3D0H/03D4H) 
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REGISTER SELECT 
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Bit R/W_ Description 
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7-5 W Always 0 
4-0 W REGISTER SELECT (RS4-RS0) 


A value between 0 and 17 written to this register selects one of 
the corresponding internal registers (RO-R17). 
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Data Register (03D1H/03D5H) 
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Bit R/W_ Description 

7-0 R/W_ Data and width are dependent upon the register selected by the 
index register. To determine if the data register can be read or 
written, see the description of the register selected by the index 
register. 
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The index and data registers can be accessed through two sets of I/O ports. 
The industry-standard set is 03D4H (index) and 03D5H (data). The DIGITAL 
extended set is 03DOH (index) and 03D1H (data). Data written to the industry- 
standard set pass through a translation ROM and then go to the CRTC, Data 
written to the DIGITAL extended set go directly to the CRTC. 


The translation ROM converts CRTC parameters, for an industry-standard 
color graphics adapter, to values that are correct for the extended capabilities 
of the DIGITAL video system. Thus, applications that directly program the 
CRTC of an industry-standard color graphics adapter function correctly. 


Table 7-7 lists the CRTC internal registers and their functions, Table 7-8 lists 
the corresponding parameters for the video modes defined in Table 7-1. The 
parameters listed in Table 7-8 are written to the CRTC through the DIGITAL 
extended I/O ports 03DOH (index) and 03D1H (data). 


Table 7-7 CRTC Internal Registers 


Register Index R/W_ Description 

RO OOH W _ Horizontal total 

Rl OLH Ww Horizontal displayed 

R2 02H W _ Horiz sync position 

R3 03H WwW Sync width 

R4 04H W Vertical total 

R5 05H Ww Vertical total adjust 

R6 06H W Vertical displayed 

R7 O7H Ww Vertical sync position 

R8 08H Ww Interlace/Skew 

R9 O9H Ww Max scan line address 
R10 OAH WwW Cursor start 

Ril OBH WwW Cursor end 

RiZ OCH R/W_ Start address (High byte) 
R13 ODH R/W_ Start address (Low byte) 
R14 OEH R/W Cursor address (High byte) 
R15 OFH R/W_ Cursor address (Low byte) 
R16 10H R Light pen (High byte) * 
R17 11H R Light pen (Low byte) * 
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* The DIGITAL video system does not support light pens. 
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200 

4-color 
640 x 640 x 
400 200 
4-color 2-color 


320 x 800 x 640 x 640 x 
200 252 200 400 
16-color 4color 4-color 2-color 80x 25 40x 25 


Register Graphics Graphics Graphics Graphics Text Text 


RO 69H 83H 69H 34H 69H 34H 
Rl 50H 64H 50H 28H 50H 28H 
R2 58H 6DH 58H 2CH 58H 2DH 
R3 58H 5AH 58H 54H 58H 54H 


R4 36H 6DH 6DH 6DH 1AH 1AH 
R5 OOH O1H OOH OOH 08H O8H 
R6 32H 3FH 64H 64H igh 19H 
R7 33H 53H 66H 66H 19H 19H 


al R8 40H 40H 42H 40H 40H 40H 
RQ 07H 03H 03H 03H OFH OFH 
R10 00H 00H 00H 00H 00H 00H 
Ril OFH OFH OFH OFH OFH OFH 
R12 00H 00H 00H 00H 00H 00H 
R13 00H 00H 00H 00H 00H 00H 
R14 00H 00H 00H 00H 00H 00H 
R15 00H 00H 00H 00H 00H 00H 
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Register RO 


HORTZONTAL TOTAL 
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Bit R/W_ Description 


hue nAeINU Sassen mitotane innocents items Meiosis catamaran attra ennai Andro panANTUI AN aeenn ME pHsP HO UNS 


7-0 W HORIZONTAL TOTAL 


This register determines the horizontal synchronization frequency. 
It is the number of displayed characters (R1) plus the retrace (in 
character times) minus one. 


_acnasnivtononsnioniatnnmennenteiet antenna nisin Anise oi rates awn eimai NNO rat nese mene Oa eesti na 


Register R1 


7 6 5 & 3 z 1 0 
rr 


HORIZONTAL DISPLAYED 


Bit R/W_ Desc pee 


von antennae hhh neconsiatnnohyatennnnnanmseneaiiuisiunaesanann ome scoters ionsuomot is netvibes eerinccmmei eA tytn ONHNBONR unasoOfoniPaueethannemenmennnsaai 


7-0 w HORIZONTAL DISPLAYED 


This register determines the number of displayed characters on a 
line. The value in Rl must i feiss than the value in RO. 


oneness a Eka te eiremoneSONE 


een sécsostonicinnt snaps esti net etm NH SOLO Ie ein Se ret SSeS i itm 


7- 28 Video Controller - Hardware Description 


Register R2 


HORIZONTAL SYNCHRONIZATION POSITION 


q cupmesbaseanteste | Swmapousosdascniaad | aauteametan saint tn A actos sdonctatuil ce uesnuaveminmrieninniqnoionimmnenornnni ees oo Ie: eee eee: 


Bit R/W_ Description 


iio Anionic iets eiaiiatdsosmneon elena cineca 


7-0 W HORIZONTAL SY NCHRONIZATION POSITION — 


This register determines the position of the horizontal synchroniza- 
tion delay and the horizontal scan delay. When this value is in- 
creased, the display shifts left. When this value is decreased, the 
display shifts right. 


sce ie oneal ie ean isi nner RUS ets itinerant ee iit em nin seeps ee OM Aesthetic enononenee amma amen 


Register R3 
7 6 5 4 3 2 1 0 


en ee ee eon TED - 
VERTI CAL SYNCHRON IZATION 
PULSE WIDTH 


eaten siiaeonenercceomnainies 


“un innvonneenmneninnnAonettnnsomorinois ito oy sree Tn hs niet icone 


HORIZONTAL SYNCHRONIZATION 
PULSE WIDTH 


HS3 HS2 HS1 HSO 
ae 


Bit R/W Deeoeuen 


esis eNO AD ei PNW a cr SSAC ADRS eee secs oan ont etna tana BIR seinen. 


7-4 W VERTICAL SYNCHRONIZATION PULSE WIDTH 


A value of 1-15 produces a pulse width of the indicated number of 
scan-line periods. A value of zero produces a pulse width of 16 
scan-line periods. 

3-0 W HORIZONTAL SYNCHRONIZATION PULSE WIDTH 


A value of 1-15 produces a pulse width of the indicated number of 
character per riods. If the value equals 0, then a horizontal synchro- 
nization jane not poe 


Seema SNOB eStats IRM Oem nO SON DHSS OSEA OM NOES ASAE SSIS SELASSIE EEN ALESIS ONDA NAIA IESE R NNSA INES NN ENT NIA NMDSN 
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Register R4 


7 6 5 4 3 2 1 0 
rt 


VERTICAL TOTAL 


1 assadadeids A cecretet am aaicaaes ean ceptions L. sees such ecto edenesernleidimedidandioer PaceseDceaet acscansmces cea measesneeaes 


Bit R/W_ Description 


siinonannsasusisicinivadntesiisinincnshtimerectnantenteetcotinnie cmmarorenmmeminsnsiuniniitrsnanniiighinirniassnti arian eanntenenawnhkbmtems OHNE intrest niiiinanrabnn opiate ai hn hrereethinninnhrhismbut 


7 Ww Always 0 
6-0 W VERTICAL TOTAL 
This value determines the vertical synchronization frequency. It is 


the number of displayed character lines plus the retrace (in charac- 
ter line times) minus one. 


-srtcenenste tee ee iii soaaeiieeeeiohhoemmgms tee tinier hii Acting inosine OOS OOH i HCO Ueno gence 


Register R5 


7 6 3. 4 3 Z 1 0 


VERTICAL TOTAL ADJUST 


eee nae ee — Toca canptatitac hen aor Micee Pete ecae 


Bit R/W_ Description 


‘Atassussoittieiomerpcat ea OREM ROvoen MONA tenant ehh vente HOMO penta ome NON tea NK RA encanta 


7-5 W Always 0 
4-0 W VERTICAL TOTAL ADJUST 


This value is the number of scan-line periods required, in addition 
to R4, to produce a vertical synchronization frequency of exactly 
50Hz or 6OHz. 
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Register R6 


F 6 5 4 3 Z 1 0 
pinto casein Sar earn ne vee Rone near SITS pa a eal tape 


VERTICAL DISPLAYED 


Bit R/W_ Description 


“ements iene payment teins ems items ents ananassae meet mimo: 


q W Always 0 
6-0 W VERTICAL DISPLAYED 


This value specifies the number of displayed character lines. It 
must be less than the value in R4. 


SE cg a eee 
7 it tl 
Register R7 


/ 6 5 4 3 2 1 0 
— . pe ee ee ee 


VERTICAL SYNCHRONIZATION POSITION 
pelea reed eee eee ee ee ee 
Bit R/W_ Description 
7 WwW Always 0 
6-0 W VERTICAL SYNCHRONIZATION POSITION 
This value determines the position of the vertical synchronization 
delay and the vertical scan delay. When this value is increased, the 
display shifts up. When this value is decreased, the display shifts 
down. 
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Register R8 


7 6 > 4 3 2 1 0 
| DISPLAY. ENABLE 


CURSOR SKEW SKEW 


INTERLACE MODE 


cs1 cso DS1 —_—dS*O 


cA annseataaVstcioninonntanintg mn cnr ee ee ene 


IMI IMO 


ALE Ree ee dl 


Bit R/W Description 

7-6 Ww CURSOR SKEW 
00 = # £=No skew 
Ol = One character skew 
10 = Two character skew 
11 = = Invalid value 


DISPLAY ENABLE SKEW 
00 = No skew 

O1 = Qne character skew 
10 = Two character skew 
ll = Invalid value 


or 
—_ 


3-2 W ~~ Always 0 


1-0 W INTERLACE MODE 
00 = Normal mode 
01 =  Interlace synchronization mode 
10 = Normal mode 
11 = Interlace synchronization and video mode 


earnest ADIN HANNA ei aE MAROON OMARION EONAR SAU i NNER eH OC EDIA Nh OSD psi tn iA Me HN AEN URONIC YA ineterronesen Ht 
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Register R9 


7 6 5 4 3 2 1 0 
Sener eee ae py 


MAXIMUM SCAN LINE 


niente nineteen eas ie Roisuonecvsnnemceacconiniseianaiononeaeonneteini J. ee ee i , ee, Seen eee 


Bit R/W_ Description 


seeps ines ecient a atin ainnviieenaseaytonayenanoeei i swenormeeinesyqsmnnmnnsionsnernnirensiny seo seston iene ntcn otters Miins smc ase rneteiiony tran hetomntavvoniormyrarnoneetsterinninrenatniniannWoneetrenrttien 


7-5 W Always 0 
4-0 W MAXIMUM SCAN LINE 


* 


This value specifies one less than the number of scan lines per 
character line including spacing. 


migrant MDa asia sisi iin eae itiesinnnit eeeaeteEGEAS fein tenia ein teow nO Mne sine Meo nese GOD I OHAORLOIN 


-sotteoninnevionenseineseeninaspuintiseseiitn into intemno 


CURSOR DISPLAY CURSOR START 
MODE 


| 


Bit R/W_ Description 


PENA IUNN SALUT IODINE eee IN NNN CNSR ta SNe iOS rei ROU i OCeStaanan HM eckson ONS iinet itn oe HNO asinine teria annonce itinemosenbansienmreha Nee e iS 


fi W _ Always 0 


6-5 W CURSOR DISPLAY MODE 
00 =  Nonblinking cursor 
01 = Cursor not displayed 
10 = Blinking cursor (3.75 Hz) 
11 =~ Blinking cursor (1.875 Hz) 


4-0 W CURSOR START 


This value specifies the scan line, within the character cell, on 
which the cursor starts. A value of 0 starts the cursor at the top 
of the character cell. 


“scenester ei noe SiH MYO ord HRN NE ANASPO tata fai ea ttn i NNO eA ets mann ns nner asueinsninongasnlmistemeceictlty tise enn NU PSA MFEERT eI ieAUNa OSE 


This register is meaningful only in text video modes. 
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a UE LORS SS OCDE era a a AREA EE OPS NNR A AT GA AARNE A GSD AN EU a a FO 


Register RII 


7 6 2 4 3 2 1 0 
a 


CURSOR END 


sna ee: LS Reems: LENNON: SMe SON ment 


Bit R/W eeeDUON 


a oneshensnSicinAnnitiisnnadremesneneveteitinincmnczestninitedsansintare init ata inant neon rene annAnetkeinssibitiineaonnenintrees ie inert neeeraRa yg AORN en nASOINUN CAs 


7-5 W Alwa ys 0 
4-0 W CURSOR END 


This value specifies the scan line, within the character cell, on 
which the cursor ends. A value of 15 ends the cursor at the 
bottom of the character cell. 


‘steno notes his sip a Io ISS ee cm ine EH iene eect QPS nae UIE HO HALOS Aeiiar oN DRC ean RIMANANOHOREEREER ASN 


This register is meaningful only in text video modes. 
Register R12 


7 6 5 4 3 2 1 0 


sonnei eaiisetsnstsinineorint 


START ADDRESS 
HIGH BYTE 


Register R13 
7 6 > 4 a 2 1 0 


a aa aaa ae aera iin T pence pe ans aa 


START ADDRESS 
LOW BYTE 


Sees ERM ee See See emia CANUTE ena! Meteor “seamen 
R12 and R13 are a write-only register pair that determine which part of the 
video RAM is used to generate the display. The address in R12 and R13 must 
be an even value. This address points to the first character position. 


~~] 
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Register R14 
7 6 5 4 3 Z i 0 


re roe ee eee : i eg ng ee eee ee 


CURSOR ADDRESS 
HIGH BYTE 


cayenne nino TEE: SATE: (se ws sonore a ae seechadast a Reacttl atetace sae en eeaee ate ee 


Register R15 
7 6 5 4 2 2 rh 0 
ese! eee OuMbenbS emeabaien ot (omens Mees Vea Ceeeaeae 


CURSOR ADDRESS 
LOW BYTE 


: ee Oe ONES SA A eT: (eee es See eee eee 
R14 and R15 are a read/write register pair that determine the location of the 
cursor as an offset from the beginning of video RAM. The address in R14 and 
R15 must be an even value. The address points to the character byte of a char- 
acter byte/attribute byte pair. 
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casa cana UREN eR ANU EN A A A a 


Register R16 


7 6 5 4 3 Z 1 0 


LIGHT PEN POSITION 
HIGH BYTE 


4 - 2 1 0 


wd 
oO 
Wr 


LIGHT PEN POSITION 
LOW BYTE 


R16 and R17 are a read only register pair that capture the CRTC refresh ad- 


NOTE 
The VAXmate workstation does not support the use of light 
pens. 
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Status Register A (O3DAH) 
| : 5 


7 6 4 3 2 ut 0 


, Naeem uci 


LIGHT PEN 


VIDEO | VIDEO 
R G 


Bit R/W_ Description 

7 R VIDEO I - Video Intensity Signal 
0 = Video intensity signal inactive 
1 = Video intensity signal active 


6 R VIDEO R - Video Red Signal 
0 = Video red signal inactive 
1 = Video red signal active 


5 R VIDEO G - Video Green Signal 
0 = Video green signal inactive 
1 = Video green signal active 


4 R VIDEO B - Video Blue Signal 
0 = Video blue signal inactive 
“it 1 = Video blue signal active 


3 R VSYNC - Vertical Synchronization 
0 = Vertical synchronization inactive 
1 = Vertical synchronization active 


LIGHT PEN (Contents undefined) 


RETRACE (Horizontal or vertical) 
Q = Dzisplay active 
1 = Retrace period 


cS 
Es 

= 

mm 


Because the dual-port RAM eliminates display interference caused 
by accessing video memory, checking this bit is not required. For 
those programs that do check, this bit flips with each read. 
Because a retrace period appears to be in effect every other time it 
is checked, this has the effect of speeding up video memory 
accesses, 


‘ecto tnNeninnetnC eM OWI IND ces CHM EASA aRe IMDM liens iro eau amare arietinum ernment ii tionship nen tennant 


| 
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Status Register B (03DDH) 


soils ooiinebestorse eA 


Bit R/W_ Description 
7 R VIDEO BLANK 
Q = Video is in an active display state 
1 = Video is in a blanking state 
6 R CR-B3 
Control Register B bit 3 (Display enabled) 
5 R CR-B5 
Control Register B bit 5 (Control register A bit 3 enable) 


CR-A4 
Control Register A bit 4 (Mode bit 2) 


3 R CR-Al 
Control Register A bit 1 (Mode bit 1} 


Z R CR-AO 
Control Register A bit 0 (Mode bit 0) 
1 R WRITE CHECK 
0 = Since the write data register (083DEH) was last read, an I/O 
write to port 03D4H or 03D5H has not occurred. 
1 = Since the write data register (03 DEH) was last read, an I/O 
write to port 03D4H or 03D5H has occurred. This bit is 
cleared by reading the write data register (03DEH). 


0 R PORT CHECK 
Q = Of the pair, 03D4H and 03D5H, 03D4H was the last port 


ne 


written. 
1 = Of the pair, 03D4H and 03D5H, 03D5H was the last port 
written. 


This bit is used in conjunction with bit 1. 


tr qiantmnnennyen Naeem esha iin maaan an sso tA ancora yiaanvnin nent iinet edn fineness hrrarnnttiteiee teenie iting nto 
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Write Data Register (03DEH) 
7 6 5 4 3 2 1 0 


Bit R/W_ Description 


seinen natty erento 


eee neonatsanesmesieihseoreis isin ean en ee ies eres nO ESNet 


easement uence yeast enasnoeneennees 


7-0 R Contains the last data written into the CRTC through register 
03D4H or 03D5H. Status register B bits 1-0 indicate which port 
the data was written to. Reading this register clears status register 
B bit 1. 


exmecsnnarderonornreontusiosonieycnmnnacenee etna neinmineounmanannatsgna.maNitan rns eesti nnn te sorbents ane oma 


avert leriostiinenrtinetenn ai e i nenmen ena renee 


Color Select Register (03D9) 
7 6 5 4 3 2 a 0 


wc ; cake notes ii 


S ee ee hares nacre 


Bit R/W_ Description 


seein tettnerwnvonmte nna omits qoananinbnreme 


7-6 W Always 0, always ignored 

5 W CPS - Color Palette Select (See Table 7-9 and Table 7-10) 

Ww SIC - Select Intensified Colors (See Table 7-9 and Table 7-10} 

3 W I - Intensity (See Table 7-9) 
2 Ww R - Red (See Table 7-9) 

1 WwW G - Green (See Table 7-9) 


) W B - Blue (See Table 7-9) 


“secon tone iinet stoma oprieret MAO 
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Zi RETR NING Ide UA at anes osrendenntsseniettentinnnat 


The use of the color select register bits depends on the current video mode. 
Table 7-9 describes the bit meanings for the affected modes. Table 7-10 
describes the color palettes selected by bits 5-4 (CPS and SIC). 


Table eas ee cata neg Bit epiariienss 
320 Xx 200 640 ; x 200 x 2- Colas 
4-Color 640 x 400 x 2-Color 
Bit Text Modes Gra pes Gi pape 


tsar Hino totes KANN ans sieemer SISRENON aC gee Noe SYS a A Se MOE HSE HOON RSet ati rte HES CONDE IBERIA 


a Ignored Ignored Ip enor a 


6 Ignored Ignored Ignored 
3 Ignored CPS Ignored 
4 Ignored SIC Ignored 


3-0 Border color Border and Foreground color 
background 
color 


tuners chasse NARA tara aeons HOSLU YA ihn connor eee aoNa EAA nen Ua eee AAS enim dna heme eNHNAN AN SHINee INIAndenientunent 


NOTE 
For the VAXmate workstation, the border color is always black. 


Table 7-10 Color pnetes poleeted by mabe and SIC 


ssiestenseinasiet nen OA oO ORECAST pono NM NNER EAHA OSORIO ODADAS SEES SSR NSN OSCE Se aS APES 


seven ts AE SINR ne Anime 


Color Bit OPS = = ay “CPS = = A CPS = 0 CPS = 1 
cbl cb0 SIC = 0 SIC = 0 SIC = 1 SIC = 1 


_isosan4t sateen Amir eee MANO evanescent ie MUON Aisne an enact icv natant ondinemonet Uitte erent inoniasnaninaihiiimesiensnutot 


0 0 Background Babkeround Background Background 


0 1 Green Cyan Light green White 


1 0 Red Magenta Light red Light magenta 
1 if Brown baa cyan Ae vero Intense white 


HS REE ON RTECS PENS ONES HSIN ASTIN ORLO RE BEIRUT DETENTION ESAS eee NENA aes iene CU AN IS SCO Snes ni ie Veeco Usa DIIOH ONE 


in the 320 x 200 4 sealer video mode. 
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4 e . 
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Control Register A (03D8H) 
7 6 5 4 3 2 1 0 


shee setae aint ophintdnaocensnsiomaceieneivunniieeonindoboinsnatie utenti 


DISPLAY | 


ENABLE| BIT 2 | ENABLE 


sigerintctgeseraiinniniigngienoniansonons and liistinehanonsoestnnoiiahinRvonisneomersaninnonnnasinnyisilineninnnidestioniosinrhesiseinitntatinmd neiinintsuivonmniinksdinsaeninnnsaninunnnnnniininsioonnassonDitidritl 


Bit R/W_ Description 


a enn eae IG SAA iAH A Ee RUOR Se SSO eee atROL 


7-6 W Always 0 
5 W BLINK ENABLE 

Q = Text mode background intensity bit (I) remains in effect 

1 = Text mode background intensity bit (1) becomes blink bit 
MODE BIT 2 (See Table 7-11) 
DISPLAY ENABLE 
If control register B (O3DFH) bit 5 equals 0, this bit is ignored. If 
control register B bit 5 equals 1, the following is true: 


Q = Display disabled 
= Display enabled 


« 


Co oh 
= < 


2 WwW Always 0 (Reserved) 
] W MODE BIT 1 (See Table 7-11) 
0 Ww MODE BIT 0 (See Table 7-11) 


Yoav AONUMA ARO eee eS a em tain tented oven niet ee pace SEN US nee sD AD et ee eA tt tae 
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Table 7-11 lists the video modes selected by the mode bits in control registers 
A and B. 


Table 7-11 


“aeriim ro mesnerieinmtas sine Oeeen sector mee Drenthe tse OR not erin NSDUH hiner ten HEH eB PAA ei yee MAE niianintnibawintanionn 


Control 


Control 


Register A 


ne UB RR UE RE ea NARS SAO RAO AT A SA TESS SS ASE CH einige nnionniaaha aaateeat Ona aon 


Selecting Video Modes 


Mode Bits Bit 


2 


intact Gunes Sitti Ne tithe nee 


0 
0 
0 


0 


eae HINA Aine nn OeeenamnenssiniesyeieoMiinheensiinmieenttenanesni 


ie 


0 
0 
i 


42 


0) 
0 
1 
0 


7 


0 
0) 
0 


0 


0 


0 


Register B 


Mode 


40 x 25 Text 
80 x 25 Text 
320 x 200 x 4 
color graphics 
320 x 200 x 16 
640 x 400 x 2 
color graphics 
640 x 200 x 4 
color graphics 
640 x 200 x 2 
color graphics 
640 x 400 x 4 
color graphics 
800 x 252 x 4 
color graphics 


enssasintnvanyponsnmoncenennet MMe emHn I 


emai inant 


Industry-standard 


Compatibility 


niin ieee a MONO ii a ONMEen 


Industry-standard 


Industry-standard 
DIGITAL extended 
DIGITAL extended 
DIGITAL extended 
Industry-standard 
DIGITAL extended 


DIGITAL extended 


‘ain nneveyponnnromanenndionntunnantamasimnettraennkinnissiibvsinnsaandigg toe enerndsnnantnrimrénenOIMHODNGOLANsWienasuniioniriuiriiit vinta 
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Control Register B (03DFH) 
7 6 2 4 a 2 1 0 


ceivitonenameraronsnneiionneninn 


| MONITOR | ¢ 
| MODE 


Bit R/W_ Description 

a W MONTIOR MODE 
0 = 400 scan lines 
1 = 252 scan lines 


6 W SCREEN SAVER 


Toggling this bit to 0 and then back to 1 blanks the display. The 
next memory or I/O access to the video address space reenables 
the display. Program to 1 for normal operation. 
5 Ww Cc R- A5 ENABLE 
0 = Control register A bit 5 ignored 
1 = Control register A bit 5 enabled 
4 WwW FONT RAM ENABLE 
Q = Access to font RAM disabled 
1 = Access to font RAM enabled 


3 Ww DISPLAY ENABLE 


arrears tanec Mieco aioe en ine oy teense 


= Display blanked 
1 = Display enabled 


2 W VLT ENABLE 
0 = Access to video look-up table disabled 
1 = Access to video look-up table enabled 


1-0 W Always 0 


naenoreotncnnaveoenv ie termes eaemnmsbemR HED 
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SRO NRRL a a 


onitor Interface 


Table 7-12 lists the monitor interface signals. These signals are applicable to 
both a monochrome or a color monitor. 


Table 7-12 ia itor iaehless Signals 


penne AH HONORA REDS Seine osm eres AEE Eine BO ED BT ASSEN RS SIELEAS ASP SASA IAS ee SIE SIE DERE UEOUSS ERLISTE SSS SOLE BLOAT EMSIRS SHEE SNA BT UNS ORNATE ASCARI 


Pin No. ‘Si ignal Description 


sv sss nO AR OREBRIL In senso vain bossa tte ROH ASS tem aonccasi _ponihaopeminccoamendsnen pnt ss “eennsensertes 


ir iarizontal ee en eet ve Taw: 
2 Vertical synchronization (active low) 

3 Intensity Video (active high) 

4 Red Video (active high) 

5 7 Green Video (active high) 

6 Blue Video (active high) 

7 400/252 select (low for 400 scans; high for 252 scans) 


8 (reserved) 


10 +5 return 

11 +6V de (200 mA max.) 

12 (spare) 

: ® “i ® grow , 7 _ 

Monitor Specification Summary 

The following are specifications for the monochrome monitor on the VAXmate 
workstation: 

CRT 340 mm (14 in) diagonal, amber or green phosphor 


Active Display 240 mm horizontal by 150 mm vertical (9.5 x 6 in) 


Resolution 640 pixels h 
800 | pixels 


1orizontal by 4 400 pixels vertical 
1 1] | 


i¢ 
orizonta 252 pixels vertical 


4 ae 


Horizontal scan rate 


Hist it 1: _s : 
26.49 kHz | (800 5 x 2! 


Vertical scan rate 


Pe %, 
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Programming Example 


“Sell” The following programming example demonstrates: 


Programming the video controller for a specific mode 
Writing the video look-up table 

Reading and writing the font RAM 

Displaying characters in text and graphics modes 


* &* * @ 


NOTE 
Whenever possible, ROM BIOS Interrupt 10H video calls are 
preferred over direct programming of the video hardware. 


Do not mix ROM BIOS calls and direct programming of the 


hardware. 


Before directly programming the hardware, use ROM BIOS calls 
to determine the state of the video system. On exit, use the 
ROM BIOS to restore the previous state. 


CAUTION 
Improper programming or improper operation of this device can 


cause the VAXmate workstation to malfunction. The scope of 


this manual. No other use is intended. 


Video Controller - Programming Example 


The example provides routines as described in the following list: 


get_mode p 


get mess _p 


wiv It 
r_w_font 


mode_ init 


mv_ cursor 
cursor on 
cursor off 


set_ mode 


screen on 


von 


soe 


Returns a pointer to a table of data about the indicated mode. 


Returns a pointer to character string that describes the indi- 
cated mode. 


Writes the video look-up table. 
Reads or writes the font ram. 


Initializes the video controller and mode registers from a table 
of data. 


Positions the cursor to the indicated row and column position. 
Positions the cursor and makes it visible. 
Makes the cursor invisible. 


Sets the current mode, clears video memory and enables the 
display. 

Enables or disables the display. 

Clears the screen by writing the appropriate values to video 
memory. 

Forms a border around the screen (like a picture frame), by 
displaying the letter E at the extreme positions of the screen. 
It also displays a message, in the center of the screen, that 
describes the current mode. 

Displays, in graphics mode, the pixel representation of a 
character. 


disp t Displays characters for text mode. 
video Sets up the conditions and executes the examples. 
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This page is intentionally blank. 
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a EE Ea AT RIE RRC OR ON SRE RRA SRS Ua 


The constants defined in this example are in the include file VIDEO.H. 
The other include files, EXAMPLE.H and KYB.H, support the example, but 
are not pertinent to the video section. 


The constant values TRUE and FALSE are used as calling parameters for sev- 
eral routines. 


The constant values CRTC_INDEX through CTRL_REGB define the ad- 
dresses, in input/output space, of the registers used to control the video mode 
and attributes. These registers are described in Table 7-7. 


The constant value VB8 defines the industry-standard start address for color 
graphics video memory. The constant value VBO defines the VAXmate ex- 
tended start address for color graphics video memory. These values are far 
pointers expressed as long integers. 


The structure type VLT defines the organization of the video look-up table. 
When access is enabled, the first byte of the video look-up table is written at 
B800H:0000H (segment:offset). The next byte is written at B800H:0002H (seg- 
ment:offset). Thus, the video look-up table can be defined as an array of 16 
structures of type VLT. Notice that this organization should be used only for 
accessing the video look-up table. It should not be used when reserving space, 


because 50 percent of the space would be wasted. 


The structure type FONT defines the organization of the font RAM. When 
access is enabled, the first byte of the font RAM is read or written at 
B800H:0000H (segment:offset). The next byte is read or written at 
B800H:0002H (segment:offset). Each character font requires 16 bytes. The font 
for each of ne possible 256 characters can be defined. Thus, the font RAM can 
be defined as a two-dimensional array of structures of type FONT, where the 
first aabecrer is 256 and the second subscript is 16. Notice that this organiza- 
tion should be used only for accessing the font RAM. It should not be used 
when reserving space, because half the space would be wasted. 


The structure type M_ TABLE defines data or pointers to data that is required 
to program the various video modes. Later in the example, an array of struc- 
tures of type M_TABLE is defined. The values used are gathered from infor- 
mation provided earlier in this chapter. 
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#include "video.h" 
#include "example.h" 
#include "kyb.h" 


[ORICA ICI IOI GO A kak ke kokok ke ake koa ak kee dea ate / 


/* Declare constants and structures used in examples * f 
JOR oi CGI OIG oko oR kok kok kok kok kkk dk 2k ak ic ak ac geo a fe ok feat oe ak ake ake ake ak ake ake okt ake ake ake teak / 


#define TRUE Oxffff /* True is nonzero */ 

#define FALSE 0x0000 /* False is zero * / 
#define CRTC_INDEX 0x03d0 /* crtc index register in i/o space */ 
#define CRIC_DATA 0Ox03di1 /* crtc data register in i/o space */ 
#define CTRL_REGA  0x03d8 /* control register A in i/o space */ 
#define COLR_SELC 0x03d9 /* color select register in i/o space */ 
#define STAT_REGA 0Ox0O3da /* status register A in i/o space * f 
#define STAT_REGB 0x03dd /* status register B in i/o space */ 
#define CTRL_REGB Ox03df /* control register B in i/o space */ 
#define VB8 Oxb8000000L /* normal base address of video memory */ 
#define VBO OxbOOOOOOOL /* extended base address */ 


typedef struct 


+ 
agai unsigned char vit _byte; /* vlt entries at even address */ 
al unsigned char skip_byte; /* skip byte at odd address */ 
> VLT: 


typedef struct 


{ 
unsigned char font _byte; /* font entries at even address */ 
unsigned char  skip_byte; /* skip byte at odd address */ 
} FONT; 


typedef struct 


if 
unsigned char  ‘*ct; /* pointer into crtc_table */ 
unsigned char «vt; /* pointer into vlt_table +*/ 
unsigned char cra: /* control register A value (Table 7-11) */ 
unsigned char Cry; /* control register B value */ 
unsigned char csr; /* color select register value (Table 7-10) */ 
long base; /* segment:offset base address */ 
unsigned int nsp; /* number of scan pages */ 
unsigned int Sps; /* scan page size */ 
“sia unsigned int cb; /* color bits per pixel */ 
unsigned int width; /* bytes per character line or scan line */ 
unsigned int length; /* in chars or pixels depending on mode */ 


} M_TABLE; 
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values us oe are thioge sted in Table 7. 8. which uiepoEte ‘all of thik defined 
VAs video modes. Notice that each state supports more than one video 
mode. In that case, the distinguishing factor is the contents of control register 
A, control register B, the color select register and the video look-up table. 
These relationships are demonstrated later in the mode_table definition. 


The array vi/ts defines two sets of video look-up table initialization values. The 
values used are those listed in Table 7-4 and Table 7-5. Notice that each state 
supports more than one video mode. These relationships are demonstrated later 
in the cecal definition. 


ce uses oe array to re thr ae re various modes as it performs the 
demonstration. 


NOTE 

The two video modes, Oxfe and Oxff, are not defined or sup- 
ported by the ROM BIOS. The mode numbers, Oxfe and Oxff, 
are defined only within the limits of this example e. 
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J RII I IORI DIG OR iGo Gio ok dk dkok doiiodokok ako kak ke ak kek sk ak ak aka / 


/* Define table values and declare globals used in examples * 
(DOO OOO CIC COR do GIG ogc koko dod doko kokok ok kok dessa / 


unsigned char crtc[6][16] = /* Refer to Table 7-7 & 7-8 */ 

{ 

{ 0x34, 0x28, Ox2d, Ox54, Oxia, 0x08, 0x19, 0x19, /* TEXT */ 
0x40, OxOf, 0x00, OxO0f, 0x00, 0x00, 0x00, Ox00 }, /x 40 x 25 */ 

{ 0x69, 0x50, 0x58, Ox58, Oxia, 0x08, 0x19, 0x19, /* TEXT */ 
0x40, OxOf, 0x00, OxOf, 0x00, 0x00, 0x00, 0x00 }, /* 80 x 25 */ 

{ 0x34, Ox28, Ox2c, 0x54, Ox6d, 0x00, 0x64, 0x66, /* GRAPHICS «/ 


0x40, 0x03, 0x00, OxOf, 0x00, 0x00, 0x00, 0x00 }, /* 320 x 200 x 4 */ 
/* 640 x 200 x 2 */ 
/* 640 x 400 x 2 */ 


{ 0x69, 0x50, 0x58, 0x58, Ox6d, 0x00, 0x64, 0x66, /* GRAPHICS */ 
0x42, 0x03, 0x00, OxOf, 0x00, 0x00, 0x00, 0x00 }, /* 640 x 400 x 4 */ 
/* 640 x 200 x 4 */ 


{ 0x83, Ox64, Ox6d, Ox5a, Ox6d, 0x01, Ox3f, 0x53, /* GRAPHICS */ 
0x40, 0x03, 0x00, OxO0f, 0x00, 0x00, 0x00, 0x00 }, /* 800 x 250 x 4 */ 


{ 0x69, 0x50, 0x58, 0x58, 0x36, 0x00, 0x32, 0x33, /* GRAPHICS «/ 
0x40, 0x07, 0x00, OxOf, 0x00, 0x00, 0x00, 0x00 }, /* 320 x 200 x 16 */ 
}; 


il 


unsigned char vlts[2] [16] 
{ 
{ 0x00, OxO1, 0x02, 0x03, /* See Table 7-4 */ 
0x04, 0x05, 0x06, Ox0e, 
0x08, 0x09, OxOa, OxOb, 
Ox0c, OxOd, Ox07, OxOf }, 


{ 0x00, 0x04, 0x08, 0x07, /8 See Table 7-5 */ 
0x00, 0x00, 0x00, 0x00, 
0x00, 0x00, 0x00, 0x00, 
0x00, 0x00, 0x00, Ox00 }, 
F 


int mode_list[{i2] = { 0x00, Ox01, 0x02, 0x03, 0x04, 0x05, 
Ox06, OxdO, Oxdi, Oxd2, Oxfe, Oxff }; 
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The array mode_table is an array of structures of type M_TABLE. Each struc- 
ture contains data or pointers to data that are required to pinkie a particular 
video mode. Refer back to the declaration of the structure type M_TABLE to 
determine the relative placement or meaning of each value. The base address, 
number of scan pages, color bits per pixel, and width are determined from 
Figure 7-3 through Figure 7-16. 


The array message is not required to program the video modes, however, the 
example program uses a string from the array message to identify and confirm 
the current video mode. The appropriate string is determined by the function 
get mess p. 


pa array ritr_e defines the character font for a reverse (mirror image) letter 
®’. It is used to demonstrate writing the font RAM and the effect it has. The 
Eee es cell size is 8 x 16. 


The array c c_font reserves enough space to store the font for an entire charac- 
ter set (25 56 characters having a cell size of 8 x 16). The example program 
copies the current contents of the font RAM to this space. 


The variable font h allows the program to dynamically change, between 


fe 


demonstrations, the height of the character font. The variable font_w is pro- 
vided for consistency. 


The variable vid_mode allows the currently selected mode to be known globally. 
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TABLE mode_table[13] = 


&crtclO 
&ertc [oO 


}{o], 
} [0], 
kcrtc[i] [0], 
&crtc[i} [0], 
Jt 


kertc[2] [0], 


&crtc[2] [0], 
&crtc[2] [0], 
&crtc([3] [0], 
&crtc[4] [0], 
&crtc[5] [0], 


M_ 
{ 
{ 
{ 
{ 
{ 
{ 
{ &crtc[2] [0], 
{ 
{ 
{ 
{ 
{ 
{ ecrtc[3) [0], 
ti 


&vits[O], 0x08, 0x68, Ox00, VB8, 


EALERTS ERRATA rete ee mnoten 


, 0x0400, 0x04, 40, 25 


8 
&vits[O], 0x08, 0x68, 0x00, VB8, 8, 0x0400, 0x04, 40, 25 
4 


&vits[O], 0x09, 0x68, 0x00, VB8, 


4, 0x0800, 0x04, 80, 25 


&vits[0O], 0x09, 0x68, 0x00, VB8, 4, 0x0800, 0x04, 80, 25 
&vits(O], OxOa, 0x68, 0x00, VB8, 2, 0x2000, 0x02, 80, 200 
&vits[O0], OxOa, 0x68, 0x00, VB8, 2, 0x2000, 0x02, 80, 200 
&kvlts[0], Oxia, 0x68, 0x07, VB8, 2, 0x2000, 0x01, 80, 200 
&vits[0], 0x18, 0x68, Ox07, VB8, 4, 0x2000, 0x01, 80, 400 


&vits[1], Oxib, 0x68, 0x00, VBO, 


4, 0x4000, 0x02, 160, 400 


a 
&vits[1], Oxib, Oxe8, 0x00, VBO, 4, 0x4000, 0x02, 200, 250 
4 


&vits[0], OxOb, 0x68, 0x00, VBB8, 


4, 0x2000, 0x04, 160, 200 


kvlts[1], 0x19, 0x68, 0x00, VB8, 2, 0x4000, 0x02, 160, 200 


char message[12][24] = 


{ 
" 40 x 25 
w. THO 26. 2S 
" 80 x 25 
" 80 x 25 
Me Se 200 
" 320 x 200 
" 640 x 200 
" 640 x 400 
" 640 x 400 
" 800 x 250 
" 320 x 200 
" 640 x 200 

7 


x 
x 
A 
x 
x 


A 


“yr 
A 


char press [32] 


char rltr_e[16] 


monochrome" 
Color", 
monochrome" 
color” 
4-color", 
monochrome" 
2-color", 
2-color", 
4~-color", 
4~color", 
16-color", 
4~color", 


b 


* 


’ 


= "Press any function key to exit"; 


= { 0x00, 0x00, Oxfe, 0x02, 0x02, 0x02, Ox7e, 0x02, 
0x02, 0x02, 0x02, Oxfe, 0x00, 0x00, 0x00, 0x00 }; 


char c_font[256] [16]: 


/* space to store current character set */ 


char c.cursor[8] = { Oxff, Oxff, Oxff, Oxff, Oxff, Oxff, Oxff, Oxff } ; 


int font_w = 8; 
int font_h = 16; 
int vid.mode = 2; 


/* font width in pixels */ 
/* font height in pixels */ 
/* current video mode */ 
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The function get mode_p provides a single source for a pointer to video mode 
data. 


NOTE 

The two video modes, Oxfe and Oxff, are not defined or sup- 
ported by the ROM BIOS. The mode numbers, Oxfe and Oxff, 
are defined only within the limits of this example. 


The function get _mess_p provides a single source for a pointer to a string that 


describes the currently selected video mode. This function is not required to 
program the video modes, however, it is used to support the example program. 
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JOO COICO OIG III IOI IG IG IG IS Gk aR aC i ki oak desk ak ak ake ak / 


/* get_mode_p() - returns a pointer to a mode table + / 
M_TABLE *get_mode_p(d_mode) /* get mode table pointer */ 
int d_mode; /* desired mode */ 
{ 
switch(d_mode) /* discover desired mode */ 
{ 
case O: return(&kmode_table[0]); /* 40 x 25 monechrome */ 
case 1: return(&mode_table[1]); /* 40x 25 color */ 
case 2: return(&mode_table[2]); /* 80 x 25 monochrome */ 
case 3: return(&mode_table[3]); /* 80 x 25 color */ 
case 4: return(&mode_table[4]); /* 320 x 200 x 4 color */ 
case 5: return(&mode_table[5]); /* 320 x 200 monochrome *«/ 
case 6: return(&mode_table[6]); /* 640 x 200 x 2 color */ 
case OxdO: return(&mode_table[7]); /* 640 x 400 x 2-color */ 
case Oxdi: return(&mode_table[8]) ; /* 640 x 400 x 4-color */ 
case Oxd2: return(&mode_table[9]) ; /* 800 x 250 x 4-color */ 
case Oxfe: return(&mode_table[10]); /* 320 x 200 x 16-color */ 
case Oxff: return(&mode_table[11]); /* 640 x 200 x 4-color */ 
} 
} 


JOO GIIGICO IO OG OO Go Gti kok tok kokok ak ok sk ak ak aca ok ak ak ak ak ake ak ake ak a ak ake / 


/* get _mess_p() returns a pointer to a string that describes the mode */ 
B, Pp p B 


JRO OOO IG Oto kokodo ie dok ice aie deale akc ic ake ake ac akc ake ak aig 2ke ok ok coke a ake oe ok akc ake ak ofc ake oko ofc oe ok afc a ae fe akc ake ae ake ake ae ake ke / 
char *get_mess_p() /* get message pointer */ 
{ 
switch(vid_mode) /* discover current mode */ 
< 
case O: return(&message[0][0]); /* 40 x 25 monochrome «/ 
case 1: return(&message[1][0]); /* 40 x 25 color */ 
case 2: return(&message[2][0]); /* 80x 25 monochrome */ 
case 3: return(&message[3][0]) ; /* 80 x 25 color */ 
case 4: return(&message[4][0]); /* 320 x 200 x 4 color */ 
case 5: return(&message[5][0]); /* 320 x 200 monochrome *«/ 
case 6: return(&message[6] [0]) ; /* 640 x 200 x 2 color */ 
case OxdO: return(&message[7][0]); /* 640 x 400 x 2-color */ 
case Oxdi: return(&message[8][0]); /* 640 x 400 x 4-color */ 
case Oxd2: return(&message[9][0]); /* 800 x 250 x 4-color */ 
case Oxfe: return(&message[10][0]); /* 320 x 200 x 16-color */ 
case Oxff: return(&message[11][0]); /* 640 x 200 x 4-color */ 


7 | 
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Snug RSE MERA RR GLEE I LUA a CARA AE A neal even age PameseedesaonngnOReRDaNnaOS ene 


The function w_vlt writes the video look-up table. 


The parameter pva is a pointer to a packed array of byte values. 


Notice that the routine waits unt 


the operation and that video output is disabled on return. 


il the start of video blanking time to perform 


/ she she the oie she ofc she ode fe oe she ode she she he ote ole ode oe oe he he ake ok okt oe ole ke he he oe he fe fe ake ake ode he fe ode he ke he ote he ake ode oft ole oe oe oe ole fe ke ode fe ode he ie fe MeO oe fe oe ae ke oe ok oe / 


/* wiv1t() - copies a set of vlt-values to the video look-up table 
JRO JOR IOI IC IR IO OIC ICC OIG CC a Ca Ca a fe ok ak ake akc akc ak eke 2k ke okt ke ak ke ok ake aie a ake // 


void w_vlt(pva) 
register char kpva; 


register int 1; 
VLT far *pvlt; 


pvlt = (VLT far *)VB8; 
while(inp(STAT_REGB) & 0x80) 


while(inp(STAT_REGB) & 0x80 == 0) 


outp(CTRL_REGB, 0x04) ; 
for(i = 0; i < 16; i++) 


vit_byte = kpvatt; 
outp(CTRL_REGB, 0); 
} 


= 


7 - 5¢ 


ee 


/* write vl1t 


/* ptr to array of characters 


/* loop counter 
/* pointer to access vit 


/* initialize pointer to vlt 
/* wait until display is active 


/* wait until beginning of 
/* display blanked 
/* enable vlt access 
/* do all 16 vlt values 
(pvlt++) -> 
/* write to vlt */ 
/* return to normal 


Video Controller - Programming Example 


*/ 


/ 


The function r_w_/font reads or writes the font RAM. If the parameter dir is 


we 


false, it reads from the font RAM. Otherwise, it writes to the font RAM. 


The parameter pfa is a pointer to a packed array of byte values. 
Notice that to access the font RAM, the current mode must be one of the text 
modes. The mode is changed temporarily and then restored to the mode indi- 
cated by vid_mode. 
Also notice that the routine waits until video blanking time to perform the op- 
eration and that video output is disabled on return. 
[COCO IO OOOO IO CCC GR II CIOS ICICI CII ICR ki rR kk ak deat aed: / 
/* r_w_font() copies the indicated number of character fonts to or * | 
/* from the font ram starting at the indicated character * f 
[OOOO III IOI IO kk RR tC dtc d kok / 
void r_w_font(pfa, dir, c_value, count) /* read or write font ram */ 
register char *«pfa; /* pointer to font array */ 
int dir; /* direction to move font data */ 
unsigned char c_value; /* atart at this char value */ 
\% Y register int count; /* number of character fonts */ 
{ 
int i: /* loop counter */ 
FONT far *pfnt; /* pointer to access font ram */ 
mode_init (2) ; /* text mode required */ 
outp(CTRL_REGB, 0x10); /* enable font ram access */ 
count <<= 4; /* 16 bytes of data per char pattern «/ 
pfnt = (FONT far *«)VB8; /* initialize pointer to font ram */ 
pfnt += (unsigned int)c_value << 4; /* offset to start of pattern */ 
if (dir) /* nonzero means write font ram */ 
while (count--) /* do requested count *«/ 
(pfint++)->font_byte = *pfat+t+; /* write to font ram */ 
else /* zero means read font ram */ 
while(count~--) /* do requested count «/ 
«pfat++ = (pfntt++)->font_byte /* read font ram */ 
outp(CTRL_REGB, 0x00); /* disable font ram access */ 
mode _init(vid_mode) ; /* restore current video mode «/ 
} 
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The function mode_init places the video processor in a predefined mode state 
as indicated by the parameter d_mode. The video look-up table is initialized 
first because w_ vIt() waits for blanking time to start its operation and the 


faqs 
?" 


display is disabled when it returns. 


Because the CRT controller is in an unstable state during initialization, the 
video output must be disabled. 


The CRT controller has 18 internal registers, RO through R17. The last two, 
R16 and R17, are read only. Thus, they are ignored during initialization. The 
crt controller has two external registers, the index register and the data regis- 
ter. To access one of the 18 internal registers, write the desired register 
number to the index register and read or write the data register. 


The control register A and color select register are initialized to ensure that the 
contents are appropriate for the mode. 


Initializing control register B would enable the display. It was not done at this 
time to prevent flashing the display if other operations have to be performed. 


look-up table from the default or preparing the video memory. 


The function mwv_cursor positions the cursor at the desired row and column 
location. 
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/* mode_init() initializes the crtc and mode registers by moving a * f 
[* table of values to the appropriate registers * f 


/ XO GIO OIG Oi io a io kok ke koko a ok ak ako ac dak coke ok ok oie ok ak ak ok ok ak ake ake ate ake ke keke / 


mode_init (d_mode) /* initialize to desired mode */ 


int d_mode; /* desired video mode */ 
4 

register int i: /* loop control */ 
register char *pc; /* pointer to crtc_table */ 
M_TABLE *pmt; /* pointer to mode_table */ 


unsigned int intr_flag; /* CPU IF state */ 


pmt = get_mode_p(d_mode) ; /* get pointer to video mode table */ 


as 


intr_flag = int_off(); 
w_vlt(pmt->vt, TRUE); 
pe = pmt~>ct; 
for(i = 0; i < 16; i++) 
{ 

outp(CRTC_INDEX, i); 


sae 


/* no interrupts please 

/* write vit data 

/* assign pointer to crtc_table 
/* do registers RO through R15 


/* indicate desired register 
/* write appropriate value 


Bs 

outp(CTRL_REGA, pmt->cra); 
outp(COLR_SELC, pmt->csr); 
int_on(intr_flag) ; 


/* set control register A */ 
/* set color select register */ 
/* allow interrupts */ 


J ACCC OIC III IO IOI IORI I RIO IOI  ICIOI ICR IS II Ike 3k aC ake ak ke ak ake ae ae cok / 


/* mv_cursor() moves the cursor to the desired location * / 
JRO oR Oo GO GIO dor IG ICICI a ao Oa oe ok ok ok ook ok ok: ae ok ok oe ok ke ae a fe ake a akc ake ake ote / 


mv_cursor(row, col) 


/* desired row */ 
/* desired column «/ 


int row; 

int col; 

int 1; 

register M_TABLE *pmt; 
unsigned int intr_flag; 


/* pointer to video mode table */ 
/* CPU IF state */ 


intr_flag = int_off(); 
pmt = get_mode_p(vid_mode) ; 
i = (pmt->width * row) + col; 


/* no interrupts please */ 
/* get pointer to video mode table + / 


if (vid_mode == 0 || vid_mode == 1 || vid mode == 2 || vid mode == 3) 
{ 


yi /* indicate desired register */ 
> 8); /* write appropriate value */ 


outp(CRIC_INDEX, 14. 
>3 
/* indicate desired register */ 


outp(CRTC_DATA, i 
outp(CRTC_INDEX, 15); 
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outp(CRIC_DATA, i & Oxff); /* write appropriate value */ 
} 


int_on(intr_flag) ; /* allow interrupts */ 


} 
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The function cursor_on positions the cursor and turns the cursor on, so that it 
is visible. 


The function cursor off turns the cursor off, so that it is invisible. 


ance 


[ORR RIGOR OOO IOI ok kk kok III AG ICI I RC CI ake oie fe ac aie ke ak ok ofc ak oe ak ak ok ak ake ake ak ake oe ake okt ate ake ake 
/* cursor_on() turns the cursor on xf 
JOR ORO Ok kkk kok a oki ako ak ak akoakok i ok ok ok kook fk oe ok ok ok ok ke ke ok ok ok ok aks ke oc 2 oe oe oie ok akc ake ake ake ofc ofc ok kek ake de a afc ok ake oe akc ake ake oe te keke 


cursor_on(row, col) 


int row; /* desired row position */ 
int ol: /* desired column position */ 


{ 
unsigned int intr_flag; /* CPU IF state */ 


if(vid_mode == 0 || vid mode == 1 || vid_mode == 2 || vid_mode == 3) 
{ 
intr_flag = int_off(); /* no interrupts please */ 
mv_cursor(row, col); 
outp(CRTC_INDEX, 10); /* indicate desired register */ 
outp(CRTC_DATA, 0); /* write appropriate value */ 
outp(CRTC_INDEX, 11); /* indicate desired register */ 
outp(CRTC_DATA, font_h ~ 1); /* write appropriate value */ 
int_on(intr_flag) ; /* allow interrupts */ 


JGR CCICIIOCIIOIG SIO ok koko kok A ROI IORI ICI I I ke ok ofc ok oe oft ake ok okt ok fe ok oe ok ac oe ak fe ae akc ak ak ake ake ake ate ake / 
/* cursor_off() turns the cursor off * f 
[eK she ke pie of ole whe ve oie she oe ode ok oe sie ote of oe ok: ole le ole ote ok the oe che she He ote ote oie obs oe hs oe ke oe ote fe ole ofc le oe ote ote oft oe oe ole oe fe ode ode ake ake ole re ak oe oe ae kook ake ake te ok / 


cursor_off( 
{ 
unsigned int intr flag; /* CPU IF state */ 
if (vid_mode == 0 || vid mode == 1 || vid mode == 2 || vid mode == 3) 
{ 
intr_flag = int_off(); /* no interrupts please */ 
outp(CRTC_INDEX, 10); /* indicate desired register */ 
outp(CRTC_DATA, 17); /* write appropriate value «/ 
int_on(intr_flag) ; /* allow interrupts */ 
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The function set_mode establishes a new video mode. It does this by initializing 
the mode, clearing the screen (video memory) to an empty (blank) state, ena- 
bling the display and advertising the new mode in vid_mode. 


Notice that the video memory is cleared after the mode is initialized. This is 
because each mode enables only certain sections of video memory. 


The function screen on enables or disables the video output as indicated by the 
parameter flag. This is done through control register B. 


JRC OIC ICICI ORI IGOR IOI ICICI OIC ICG Gk GI iC ICI I Cake ak ake ak ick ak a ok aca ak ak ake ak ae a ake ake ake / 


/* gset_mode() sets the mode as indicated, clears the screen and * | 
/* sets the current video mode flag * | 
DCCC OOOO IO IG oC Ick Go do iO i kak a ik kook ako k ek leak ack ake aca ke ake ae teak ake akc ake ake ak / 
set_mode(d_mode) /* set desired video mode */ 
int d_mode; /* desired mode */ 
< 
M_TABLE *pmt; /* pointer to mode_table */ 
vid_mode = d_mode; /* tell world what new mode is */ 
pmt = get_mode_p(d_mode) ; /* get pointer to video mode table */ 
mode_init (d_mode) ; /* disable display & initialize mode */ 
clear_vid_mem(); /* clear screen */ 
screen_on(TRUE) ; /* enable the display */ 
} 


JDO OR OIC IOI IGOR IOIGII OGIO III I OI kak ak a ke ki i kk kok aca CACC ICC a ak fc a ok ake ak ake akc ake / 


/* screen_on() enables or disables the display (blanking / unblanking) */ 
JGR OR IIOIO IOC IO IO OR ICG i icdok ok kok kok ak ak ic ack ak ale akoke ake ake ak ak ak ake ak i a ake ae te / 


screen_on(flag) /* disable or enable display */ 
int flag; /* what to do */ 
+ 
register M_TABLE *pmt; /* pointer to video mode table */ 
if (flag) /* nonzero means enable display */ 
{ 
pmt = get_mode_p(vid_mode) ; /* get pointer to video mode table */ 
outp(CTRL_REGB, pmt->crb); /* control reg B enables display */ 
} 
else outp(CTRL_REGB, 0); /* all bits off will disable */ 
F 
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The function clear_vid_mem initializes video memory to a value appropriate for 
the current mode. That is, in text modes the character byte is set to a space 
and a black background. For graphics modes, the color bits are set to zero 
(black). Only the addressable video memory is initialized. 


Notice that the pointer to video memory is declared as a pointer to an integer. 
The video memory data bus is a full 16-bit bus. Because text mode utilizes a 
character and attribute byte pair and graphics mode values are all zero, it is 
appropriate to take advantage of the 16-bit data bus. Also, the normal storage 
for an integer is low byte first and high byte second. 


The scan page size is specified in bytes. To calculate the correct memory size, 
the number of scan pages is multiplied by half of the scan page size. 


JX ROO OR IO SO dO GR ak oR ok ok oki ok ook de ak kok dc ak ok ok ak ae ak ste ak / 


/* clear_vid_mem() based on the current mode, video memory is cleared */ 


/* to spaces or NULLs. The size of memory to clear * / 
/* is calculated from the mode table. * | 


JOO Ro ggoookgododokoiok ok okokok kkk ick kak sok kok skokok kok dk dak aeokok ka / 


clear_vid_mem() 
{ 
register unsigned int size; /* loop control */ 
int far *pvm; /* pointer to video memory */ 
M_TABLE *pmt; /* pointer to video mode table */ 
pmt = get_mode_p(vid_mode) ; /* ptr to current mode data */ 
pyvm = (int far *)pmt->base; /* ptr to start of video mem */ 
size = pmt->nsp * (pmt->sps >> 1); /* number of integers to init */ 
switch (vid_mode) /* text or graphics mode ? */ 
‘ 
case 0: /* text modes initialized to */ 
case 1: /* a space character with */ 
case 2: /* medium intensity */ 
case 3: 
while(size--) *pvm++ = 0x0720; /* write char & attribute */ 
break; 
default: /* for graphics modes, just */ 
while(size--) *pvm++ = 0x0000; /* set all bits off */ 


break; 
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The function do border displays the indicated character in a pattern or border 
(like a picture frame) at the extremes of the screen. It first decides whether the 
mode is a text mode or a graphics mode. For text mode, it retrieves the row 
and column counts from the mode table. Graphics mode programming is 
slightly more difficult. The row count is calculated by dividing the total scan 
lines by the fonts scan line height. The column count is calculated by dividing 
scan line width (measured in bytes) by the the number of color bits per pixel 
(only character fonts 8 pixels wide are supported in the example}. 


It then executes a for loop to generate the pattern. After the pattern is 
displayed, a message is displayed describing the current video mode. Notice 
that in graphics mode, the font height is temporarily changed to display the 
message. This is because the message is displayed using an 8 x 16 character 
font and it must be accommodated when displaying the border in an 8 x 8 
character font. 


JOO ROO Ook aR kok kok ka Hook ake ak de ak i akcko sk dk kok de ick oi ok ok ok ok ak ak oi ae ae oe ake ak ok ok ake ake ke deka ok kok ete / 
/* do border () From the mode table, the maximum number of * f 
/* displayable lines is calculated and a border « f 


f., * i : & a ‘dle i oe 3 er : 
{* is drawn using the indicated character. * f 
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do_border (pc) 


char DC | 


unsigned char attr; 
char *pM ; 

int row, rows: 
int col, cols: 


pmt = get_mode_p(vid_mode) ; /* get pointer to mode table */ 
pm = get_mess_p(vid_mode) ; /* get pointer to message */ 
switch(vid_mode) /* discover the current mode */ 
Fi 

case 0: /* text mode O or */ 
text mode i or *, 
{x text mode 2 or */ 
text mode 4 


case 
case 
case 3: 
attr = 0x07; /* black background & med 
rows = pmt->length; /* length specif 
cols = pmt->wi idth; /* width spec ind ag 4 


Sa, i, 
is 


ium intensity fore 
t 


ied in 


7- 64 Video Controller - Programming Example 


cnt ee aes 


or(row = 0; row < rows; row++) 


{ 


/* write left side 
/* first or last row 


disp_t(row, 0, *pc, attr); 
if(row == || row == rows - 1) 
for(col = 1; col < cols - 1; col++) 
disp_t(row, col, *pc, attr); 


disp_t(row, cols - 1, *pc, attr); /* write right side 


+ 
col = (cols - strlen(pm)) >> 1; /* center message 
while (*pm) 
disp_t(rows >> 1, col++, *pm++, attr); /* do message 
pm = press; 
col = (cols - strlen(pm)) >> 1; /* center message 
while(*pm) 
disp_t((rows >> 1) + 1, colt+t+, *pm++, attr); /* do message 
break; 
default: 
attr = Oxff >> (8 - pmt->cb); /* medium intensity 
rows = pmt->length / font_h; /* rows for this font 
cols = pmt->width / pmt->cb; /* columns this mode 
for(row = 0; row < rows; rowt+) /* do all rows 
{ 
disp_t(row, 0, *pc, attr); /* write left side 
if (row == 0 || row == rows - 1) 


for(col = 1; col < cols - 1; col+t+) 
disp_t(row, col, *pc, attr); 


disp_t(row, cols - 1, *pc, attr); /* write right side 
25 
t_font_h = font_h; /* save current font 
font_h = 16; /* message font is 8 x 16 
col = (cols - strlen(pm)) >> 1; /* center message 
while (*pm) 


disp_t(pmt->length >> 5, col++, *pmt++, attr); /* do message 
pm = press; 
col = (cols - strlen(pm)) >> 1; /* center message 
while(*pm) 

disp_t((rows >> 1) + 1, colt++, *pm++, attr); /* do message 
font_h = t_font_h; /* restore current font 
break; 


*/ 
*/ 
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The function disp_g displays a character at the desired row and column loca- 
tion. The color bit pixels that form the character are set to value in attr. The 
routine assumes that it is provided an attribute that is consistent with the 
number of color bits per pixel. 


The routine calculates the position as a constant offset to the first byte of the 
first scan line. After the scan line has been displayed, the scan line offset is 
the scan line offset is zeroed and the constant offset is incremented by the 
length of one scan line. The actual position is the constant offset plus the scan 
line offset. 


The middle for loop ensures that all eight pixels of the scan line are displayed. 
For example, a 16-color display requires four color bits per pixel or four bytes 
per character scan line. 


For each pixel, the interior for loop shifts the color bit image and if the pixel 
bit is set, the color bit attribute is OHed into the color bit image. The number 
of pixel representations per byte is determined by dividing the font width by 
the number of color bits per pixel. Only eight pixel wide fonts are supported by 
the example. 
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/* 


f* 


disp_g() 
row and column 


Draws a character in graphics mode at the calculated 


«/ 
«/ 


position. 


DOO OOOO OIC ICICI I doko ki kok ok ides sk sk ok ak ok ak ok ok kate ake ak ak cok ka ok ae akc ake akc ake ake a ake ot ok ke ke / 


disp_g(row, col, pe, attr) 


int row, 
register 
unsigned 
{ 
unsigned 
unsigned 
unsigned 
int bc; 
int tbc; 
int scan; 
long c_off; 

unsigned int s_off; 
register M_TABLE *pmt; 


col: 
unsigned char *pc; 
char attr; 


char far *pvm; 


char bi; 
char bd; 


pmt = get_mode_p(vid_mode) ; 


c_off = pmt->base + (col * pmt->cb) + 


/* pointer to video memory * 
/* bit image * 

/* for bit testing 

/* bit count (current) 

/* terminating bit count 
/* current scan line 

/* character offset 

/* scan line offset 

/* mode data 


/* get pointer to mode table 
/* address of first byte 


(row * pmt->width * (font_h / pmt->nsp)); 


tbe = font_w / pmt->cb; 
s_off = 0; 
for(scan = 0; 
{ 

if(scan && scan % pmt->nsp 


{ 


c_off += pmt->width; 
s_off = O; 
} 


pyvm = (char far *)(c_off + 


/* bit image bit count per byte > 
/* scan line offset 
scantt+, pct++) /* do all scan lines 


== () /* done all scan pages ? 


/* offset by one scan line * 
/* reset to first scan page > 


s_off); /* ptr to first byte of scan * 


s_off += pmt->sps; /* offset to next scan page, for next pass */ 
for(bd = 0x80; bd;) /* start at left most bit/pixel */ 
{ 
bi = 0x00; /* null bit image */ 
for(bc = 0; be < thc: bct+, bd >>= 1) /* do a byte of scan */ 
{ 
bi <<= pmt->cb; /* shift bit image by # of color bits */ 
if(*pe & bd) bi |= attr; /* or in next bit image */ 
} 
*pvmt+ = bi; /* write a byte of scan line * f 
} 


} 


Video Controller - Programming Example 


7- 67 


The function disp t displays a character and attribute at the desired row and 
column location. 

The example uses zero-based row and column values. When calculating the po- 
sition, this saves subtracting one from the row and column values. 


Notice that the pointer to video memory is declared as a pointer to an integer. 
The video memory data bus is a full 16-bit bus. Because text mode utilizes a 
character and attribute byte pair, it is appropriate to take advantage of the 
16-bit data bus. Also, the normal storage for an integer is low byte first and 


ti 


high byte second. 


OOOO OI OIC I II OR OIC IO OR II ko RO kG a HO IOk ae dea ak fete ake ake ae / 


/* disp_t() writes a character and its attribute to the indicated */ 
{* row and column position * f 


[DORR OO CIO lok OR SR a OR I KI IC i ae ak ake aks ake kook ake ak ok ok kok ake ode akc ake ake ake ok / 


disp_t(row, col, c, attr) 


int row; 
int col; 


unsigned char c; 

unsigned char attr; 

{ 

int far *pvm; /* pointer to video memory */ 
register M_TABLE *pmt; 


if (vid_mode == 0 | vid_mode == 1 | vid_mode == 2 | vid_mode == 3) 
4. 
pmt = get_mode_p(vid_mode) ; /* get pointer to mode table */ 


/* get address of character */ 
pyvm = (int far *)(pmt->base + 
(row * (pmt->width << 1) + (col << 1))); 


*pvm = (Cint)attr << 8) | (int)c; /* character & attribute */ 
} 
else disp_g(row, col, &c_font[c][0], attr); 
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ee 


The function video sets up various conditions and executes the example pro- 
gram. The major points are: 


% 


2. Select a video mode. 


Read the current font and save it. 


4. Restore the pattern of the letter ‘E’ from the saved font. 


wo 


5. Display the letter ‘E’ border pattern in the selected video mode. 


6. Restore the video mode to mode 3 and exit. 


3. Change the pattern of the letter ‘E’ to a mirror image of the letter ‘E.' 


[ROO IO GO I I OI dG tok dokko kodak sk dkok ak kde ok desk sk ska a de ake ake ake ake ake ke dea ake ote ake ke / 


/* video() - execute video examples 
JOR OK kok kk ko OR OC oo oR OR aR ok ok dk aE ok ak ok ok ok ok ak ake ok akc ok ot akc akc akc ake akc ofc oie ae ok fe akc ake akc oke of oe ake ae atc ake / 


video() 


{ 


static MESSAGE mvid[] = 


{ 


3 
5, 24, "Fl. 
6, 24, "F2. 
7, 24, "F3. 
8, 24, "F4. 
9, 24, "F10. 
DO, O Os, 


ras pty pi pte pi pt py 


ae 


}, 33, "Video Example" }, 


Select video mode" }, 
Invert letter E" }, 
Restore letter E" }, 


Display selected video mode" }, 


Return to Main menu" }, 


static MESSAGE mvmd[] = 


{ 


Bq ee VEL 
6, 24, "F2. 
7, 24, "F3. 
8, 24, "F4. 
9, 24, "FS. 
10, 24, "FG. 
mee am oe a 
12, 24, "F8. 
13, 24, "FQ. 
14, 24, "F110. 
O, Oy. x. 


tee OE ie oe oe gen ne ee, ts en 


ne[{512]: 


bee 


char 1: 


40 x 


25 


3, 31, "Select Video Mode" }, 
Text" }, 


80 x 25 Text" }, 


320 
320 
640 
640 
640 
640 
800 


se  OOS 


xX 


200 
200 
200 
200 


400 x 


400 
252 


Return to 


x 4-color" }, 
x 16-color" }, 
x 2-color" }, 
* 4-color” +}, 
x 2-color" }, 
x 4-color" }, 
x 4-color" }, 


video example" }, 


/* video 


/* video 


/* to hold input 
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*/ 


menu */ 


menu */ 


line */ 
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int i; 
int mode; 
unsigned char c; 


“~ 


r_w_font(&c_font[0][0], FALSE, 0x00, 256); 


set _mode(3); 


disp_menu(mvid) ; 


while (1) 
{ 


switch(line[0]) 


A 


case FI: 


disp_menu (mvmd) ; 


line[O] = get_fkey(; 


switch(line[0]) 


{ 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 

} 

break; 


case F2: 


| on es 
F2: 
F3? 
F4: 
FS: 
F6: 
F7: 
F8: 
FQ: 
FiO: break; 


mode 
mode 
mode 
mode 
mode 
mode 
mode 
mode 
mode 


coe 


Oxfe; 


= 6: 


Oxff:; 
Oxdo; 
Oxdl1; 
Oxd2:; 


/* to hold menu selection */ 
/* temp value for mode */ 


/* read all font ram */ 

/* reset video mode */ 

/* display the video menu */ 
/* null terminated */ 

/* forever (see F10) */ 


/* determine menu selection */ 


/* select video mode */ 
/* display the mode menu */ 
/* get a function key selection */ 


break; 
break; 
break; 
break; 
break: 
break; 
break; 
break; 
break; 


£ 


/* reverse ’E’ to font ram */ 


r_w_font(&rltr_e[O], TRUE, ’E’, 1); 
set_mode(3) ; 


break: 


case F3: 


/* reset video mode */ 


/* restore 'E' to font ram */ 


r_w font(&c_font['E’][0], TRUE, ’E’, 1); 
set_mode(3): 


break: 


case F4: 


set _mode(mode) ; 
do_border("E") ; 
while(1) if(get_key(&c) >= 0 && c == 0) break; 
while(1) if(get_key(&c) >= 0) break; 

set_mode(3) ; 


break; 


/* reset video mode */ 


/* display selected mode */ 
/* get the desired mode */ 
/* write letter 'E’ at screen extremes */ 


/* set the desired mode */ 
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case F10: /* return to caller (main menu) */ 
a return; 
disp_menu(mvid) ; /* display the rtc menu */ 
line({O] = get_fkey(); /* get a function key for menu selection */ 
} 
} 
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Chapter 8 
Keyboard-Interface Controller 
and Keyboard 


Introduction 


The keyboard-interface controller is an Intel 8042 microcomputer with internal 
firmware developed by DIGITAL. The keyboard-interface controller provides a 
physical and logical interface between the LK250 keyboard and the VAXmate 
CPU. Also, it provides several hardware control functions that are unrelated to 
the LK250 keyboard. 


The LK250 keyboard is an intelligent keyboard with 105 keys. The keys are 
divided into functional groups as follows: 


57 key main section 
20 key function-key section 
18 key keypad sectio 
10 key aux 


ciliary a nd direction key section 


Keyboard-Interface Controller 


Physical Interface to the CPU 


nh — chk te bein J com mu Gis tes with the keyboard-interface contr ol we 


006 4H. The ae. acces sed Keough these ports are: 


Reading port 0064H accesses the status register. 

Writing port 0064H accesses the command register. 
Reading port O060H accesses the output data register. 
Writing port 0O60H accesses the input data register. 


The contents and usage of these registers are described later in this chapter. 
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Physical Interface to the Keyboard 


The keyboard-interface controller communicates with the LK250 keyboard over 
a bi-directional serial data line. A second line provides serial clock rate. A com- 
bination of signals and timing on the serial clock line provides the communica- 
tions protocol. These lines are in the coiled cable that connects the LK250 
keyboard and the VAXmate workstation. 


Logical Interface 


The keyboard-interface controller has two modes of operation, pass-through or 
translate. In pass-through mode, all data received from the LK250 keyboard 


are stored in the output buffer without modification. In translate mode, all data 
in the range 0OH-99H and FOH are translated to an industry-standard or a 


DIGITAL extended scan code and stored in the output buffer. Bit 6 of the 
command byte controls this mode of operation. The keyboard-interface control- 
lers default mode is pass through. 


NOTE 

During the system powerup initialization, the ROM BIOS sets 
the keyboard-interface controller to translate mode. Therefore, 
the operating system sees the keyboard-interface controller in 
translate mode. 
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Control Functions 


The keyboard-interface controller performs some control and status functions 
that are unrelated to LK250 keyboard operation. Therefore, the keyboard- 
interface controller has two 8-bit ports, port 1 and port 2, that are in the, 
keyboard-interface controller I/O address space. Commands are available that 
instruct the keyboard-interface controller to read port 1 and read or write port 
2. Those commands are discussed in the command register section. Table 8-1 
defines the port 1 bits and Table 8-2 defines the port 2 bits. 


Table 8-1 Port 1 Bit Definitions 


Bit Description 
Undefined 
6 Always 0) 
5-3 Undefined 
Z EXPANSION BOX INSTALLED 
Q = Expansion box installed 
1 = Expansion box not installed 
1 RAM OPTION INSTALLED 


0 = RAM option installed 

1 = RAM option not installed 
0 RAM OPTION ERROR 

Q = RAM option parity error 

1 = No error 
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Table ae 2 Port 2 doce Definitions 
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7 Keyboard data ioupad 
6 Keyboard clock inverted (output) 
5 Undefined 
4 CPU IRQ1 
Q = Keyboard-interface control 
1 = Keyboard-interface control 
3 Undefined 
a Undefined 
1 Gate system address line 20 
0 = System address line 20 enabled. Use this state for 80286 vir- 
tual protected mode. 
1 = System address line 20 disabled. Use this state for 80286 real 
mode. 
0 Reset ee CPU (affects only the CPU) 
0 = 80286 CPU in reset state 
| = 30: 286 CPU not in reset state 


eta sine een SSDS ADU SDD FEMS REO Da eS eS ese ep NSO US SHES ESO LDA ASR EGE SSSI tS EE tine ON eSB AU SOS ta a NT 


ler not interrupting’ 
ler interrupt to CPU 


Keyboard-Interface C ia 


On powerup, the keyboard-interface controller executes a sneha ic test. The 
test verifies the keyboard-interface controllers ROM and RAM. The keyboard- 
interface controller completes the test within 200 ms after powerup. During the 
powerup test, the LK250 keyboard is ignored. 


Failing this test is considered a fatal system error. If an error occurs during 
powerup testing, the keyboard-interface controller will not respond to any input, 
and must be reset. To reset the keyboard-interface controller, turn the 
VAXmate workstation off and then on. 
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Keyboard-Interface Controller Registers 
Data Register (0060H) 


y 6 2 4 3 2 1 0 
Ga eee pelt nee 


DATA 
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Bit R/W_ Description 


nnn serena entertains sities neds annie einen iteminstedie oats iinet sinistral eben DORON NOH arse 


7-0 R/W The CPU reads or writes this port to exchange data with the 
keyboard-interface controller 
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Command Register (0064H) 


/ 6 5 4 3 2 1 0 


pirorrmmetemetrntininanitnintoreisensnntin Re eT ee Se etn ee ee pe ae eae ee ee ee ee ee 


STATUS OR COMMAND REGISTER 


-seiniaudersiatononosesiastosssc seen siwosmasnsomininiisisuienseraseuntosOndeiounatnnaniencneneinnesain ss eso HeSAOAieoNone rset CONSE BOOIN SOE aa PAIRS AM RENAN 


7-0 R The CPU reads the keyboard-interface controller status register 
Ww The CPU writes the keyboard-interface controller command 
register 
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Status Register (0064H) 


mi unserer 


SWITCH 


So teem A 


Bit R/W_ Description 


1 R PARITY ERROR 
0 = No parity error 


1 = Parity error 


The keyboard to keyboard-interface controller serial communica- 
tions use odd parity checking. When data from the keyboard con- 
tains a parity error, this bit is set to 1. Reading the status register 
clears this bit. 

6 R RECEIVE TIMEOUT 
0 = No receive timeout error 
1 = An in-progress transmission from the keyboard was not com- 

pleted within 2 ms. 

Reading the status register clears this bit. 

5 R XMIT TIMEOUT - Transmit Timeout 
Q = No transmit timeout error 


= An in-progress transmission from the keyboard-interface con- 
troller to the keyboard was not completed within 2 ms. 


Reading the status register clears this bit. 


This bit is also used in combination with the parity error bit or the 
receive timeout bit to establish additional error conditions as 
follows: 


e If the transmission to the keyboard completes within 2 ms, but 
the response from the keyboard is not received within 20 ms, 
then the transmit and receive timeout bits are set to 1. 


e If the transmission to the keyboard and the response from the 
keyboard complete within the designated time frame, but the 


response contains a parity error, then the transmit timeout 
and parity error bits are set to 1. 


72) 
i 

site, 

reat oe 


Keyboard-Interface Controller - Hardware Description 


R/W vesempuon (Status Register - cont.) 


R 


vein 


KEYBRD INHIBIT SWITCH - Keyboard Inhibit Switch 
Q = Keyboard is inhibited (locked) 
1 = Keyboard is active (unlocked) 


The VAXmate workstation does not have a keyboard lock, so this 
bit is always set to 1. 


COMMAND/DATA 

QO = Of the pair (0060H/0064H), the last I/O write was to the 
data register, at I/O address O060H. 

1 = Of the pair (0060H/0064H), the last I/O write was to the 
command register, at I/O address 0064H. 


This bit is used internally by the keyboard-interface controller. It 
determines whether the byte in the keyboard-interface controllers 
input buffer is a command or data. 


SYSTEM FLAG 

0 = ROM BIOS should execute a normal powerup initialization 
process 

1 = A virtual protected mode task request to reset the CPU to 
real mode 


The ROM BIOS interprets the state of the system flag to deter- 
mine the reason the VAXmate CPU reset pin was toggled. If the 
system flag is set, the VAXmate CPU is returning to real mode 
from virtual protected mode. Otherwise, the ROM BIOS executes 
a normal powerup initialization process. 


During the keyboard-interface controllers powerup initialization se- 
quence, the keyboard- interface controller clears the system flag to 
(). 


Setting or clearing the system flag is a two step process: Issue a 
write-command-byte instruction by writing the value 0060H to the 
command register at I/O address 0064H. The write-command-byte 
instruction is discussed in detail later in this chapter. 


Write the command byte to the input data register at I/O address 
OO60H. The system flag reflects the value of bit 2 of the command 
byte. If bit 2 of the command byte is set to 1, so is the system 
flag. When bit 2 is 0, the system flag is cleared to 0. 
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Bit R/W_ Description (Status Register - cont.) 
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1 R INPUT BUFFER FULL 
0 = Keyboard-interface controller input data buffer is empty 
1 = Keyboard: Biioridcanig c POUETONEY eae data butter c ons data 
contr oller 


Data ani tees Bs the anpet data sce is tr ee to t he 


the sala of ie ue or A buffer. 
Q R OUTPUT BUFFER FULL 


= Keyboard-interface controller output data buffer is empty 
1 = Keyboard-interface controller output data buffer contains 
data that the CPU has not read 


stint nthe Sesion ort OLOSNOse SNA NYM DDS BTADie ai AA CAN USL saat OREN HASH ESSN ISLA SINAaMADNA IIIA iSSSNSHADENONMISSIRAH SSUES SHI SSS MEAD SIIIADS. 


nese nner aes 


It contains oe abait the k pena Water on ec pees ana ae 
Status changes do not cause an interrupt. The status register can be read at 
any time. 


The keyboard-interface controller command E1H allows the CPU to initialize 
bits 7-4 of the status register. See the keyboard-interface controller command 
register description, 
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Command Register (0064H) 


7 6 3 4 3 2 1 0 
eee eee ee ees le 


COMMAND DATA 


Bit Description 


_rmenesannotnhtnrterieenH ANSI NUANCED AON titer thonianansaessnnnansvnsiaontnintrraaihainrseinienndnastinrinnde einen esi iienten enti nomenon nnennmtnAranrnnns nA nrerA 


eyboard-interface controller commands from the CPU 


~ A, 
af 
semsmsepineon peinennrmnaattanneassn initiatives enh nnn etnies nents een 


The data written to this register are instructions to the keyboard-interface con- 
troller. Table 8-3 lists the keyboard-interface controller commands. 


Table 8-3 Keyboard-Interface Controller Commands 


easiest ONS anasenmeeQOtnn Yeerks cre 


Command Description Command Description 
Value Value 


‘oseeannenainonnt enn oineeisstinininioaninie MGB soto sere san anmeenentnen iota aaommrancnoeseinvAanecen easiness pnt eine 


QOH-1FH Reserved COH Read Port 1 
20H Read command byte C1H Read Port 1 
21H-5FH Reserved C2H-CFH Reserved 

60H Write command byte DOH Read Port 2 
61H-A9H Reserved D1H Write Port 2 
AAH Self-test D2H-DFH Reserved 

ABH Interface test EOH Read test inputs 


otoconia initiative Givin btn 


tennessee peeninemesesae nia etnies 


ACH Reserved for expansion E1H Write status 


ADH Disable keyboard E2H-EFH Reserved 
AEH Enable keyboard FOH-FFH Pulse output port 
AFH-BFH — Reserved eae el 


“eine yeoman conference eis METER HES agen sseneaetrtelatcror kitten noisemakers Tint settee mone ee 
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Read Command Byte (20H) 

Write Command Byte (60H) 

The keyboard-interface controller has an internally stored command byte that 
determines how the interface controller responds to various conditions. The two 
commands, read command byte and write command byte, provide access to 
that command byte. When the keyboard-interface controller receives a read- 
command-byte command, it places the internally stored command byte in the 
output buffer. When the keyboard-interface controller receives a write- 
command-byte command, it stores the next data byte, written to the input data 
register at I/O address O0O60H, to the internally stored command byte. Table 
8-4 defines the command byte bits. 


Table 8-4 Command Byte Bit Definitions 


nannies ODORS nn tii i cement eee onsen En net yee ulema anon ennai: 


Bit R/W_ Definition 


7 R/W_ Always 0 


6 R/W_ Scan Code Type 
Q = The LK250 scan codes are passed through without conver- 
sion (pass-through mode). 
1 = The keyboard-interface controller converts the LK250 key- 
board scan codes to industry-standard one pinie values 
(translate mode). 


5 R/W_ Interface Type - Always 0 


4 R/W_ Disable Keyboard 
Q = Keyboard enabled 
1 = Keyboard disabled 


The keyboard-interface controller disables the keyboard by setting 
the clock line to a low state. This bit is cleared by writing this 
command byte or by writing LK250 keyboard data to the input. 
data register at I/O address 0060H. 


3 R/W_ Inhibit Override 
0 = Keyboard inhibit switch enabled (see status register bit 4). 
1 = Keyboard inhibit switch disabled and the key lock function is 
overridden (see status register bit 4). 


anenenonasenntnessnomtemoenen tener: 
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Table 8-4 Command Byte Bit Definitions (cont.) 


Ss a a a ah a gh cn a rs ar A ii ee 
ie “t + * we * 
it elinition 
Be # A if Ai: Bd is. td bs A 
: Eades ac cp ge a Sa a a ct ee ee eae 


a RIW eter Flag 
0 = ROM BIOS should execute a normal powerup initialization 
process 
1 = A virtual protected mode task request to reset the CPU to 
real mode 


The ROM BIOS interprets the state of the system flag to deter- 
mine the reason the VAXmate CPU reset pin was toggled. If the 
system flag is set, the VAXmate CPU is returning to real mode 

from virtual protected mode. Otherwise, the ROM BIOS executes 
a normal powerup initialization process. 


During the keyboard-interface controllers powerup initialization se- 
quence, the keyboard-interface controller clears the system flag to 
zero. 


See the status register bit 2 description. 
1 R/W_ Always 0 


0 R/W_ Enable Output-Buffer-Full Interrupt 
0 = Keyboard-interface controller does not generate interrupts to 
the CPU 
1 = When the keyboard-interface controller places data in the 
output buffer, the keyboard-interface controller generates an 
interrupt to the VAXmate CPU. 


vse nesmneasongunmeeasannaitonnonnacrav enthuse meinen i serene mn ntenecascahooannanenen ionising oii opium earmark pinnae nomena OIOON A 
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Self-Test (AAH) 

This command: causes vee Maca iail en Saas as to adhe eae eS 
ane to te VAXn nate CPU J are disabled, The Spaicn ‘ag eae eee 
bit 2) is not changed. One of three possible diagnostic result codes is placed in 
the output buffer. 


Diagnostic Code Madauacc’ 

55H No errors .eteuea 
FEH Invalid ROM checksum 
FDH basic paoits kee 


Interface Test (ABH) 
This command causes the keyboard-interface controller to test the state of the 
LK250 keyboard-interface lines. One of five possible diagnostic result codes is 
placed in the output buffer. 


Diagnostic Code Meaning 

00H No errors det ‘ected 

O1H LK250 keyboard clock line always low 
02H LK250 keyboard clock line always high 
03H LK250 keyboard data line always low 
04H LK250 meyanare. ea ine é aways cae 


Disable Keyboard (ADH) 

This command sets bit 4 of the keyboard-interface controller command byte. 
The keyboard-interface controller disables the k eyboard-interface by setting the 
clock line low. 


Enable Keyboard (AEH) 

This command clears bit 4 of the keyboard-interface controller command byte. 
The keyboard-interface controller enables the keyboard interface by freeing the 
clock line. 


Read Port 1 (CQH) 

The keyboard-interface controller reads port 1 (bits 7-0), sets bits 3-0 to 1 (for 
compatibility), and places the result in the output buffer. For port 1 bit 
definitions, see Table 8-1. Because it overwrites any data in the buffer, this 
command should not be used unless the output buffer is empty. 


Read Port 1 (C1H) 
The keyboard-interface controller reads port 1 (bits 7-0) and teh bits 7-0 
(without modification) in the output buffer. For port 1 bit definitions, see 
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Table 8-1. Because it overwrites any data in the buffer, this command should 
not be used unless the output buffer is empty. 


Read Port 2 (DOH) 

The keyboard-interface controller reads port 2 (bits 7-0) and places bits 7-0 in 
the output buffer. For port 2 bit definitions, see Table 8-2. Because it over- 
writes any data in the buffer, this command should not be used unless the 
output buffer is empty. 


Write Port 2 (D1H) 

The keyboard-interface controller takes the next byte of data written to the 
input data register at I/O address 0060H and writes it to the keyboard- 
interface controller output port 2. For port 2 bit definitions, see Table 8-2. 


CAUTION 

Bit 0 of keyboard-interface controller output port 2 is connected 
to the VAXmate CPU reset circuitry. Clearing bit 0 to a zero 
places the VAXmate CPU in a permanent reset state. 


Read Test Inputs (EOH) 

The keyboard-interface controller reads its TO and Tl inputs and places the 
data in the output buffer. This command writes over any data in the output 
buffer that has not been read by the CPU. Bit 0 corresponds to the state of TO 
and bit 1 corresponds to the state of T1. 


Write Status Register (E1H) 

This is a diagnostic command. The keyboard-interface controller takes bits 7-4 
of the next byte written to the input data register (60H) and writes them to 
bits 7-4 of the status register. Only bits 7-4 are affected. 


After the next keyboard-interface controller command that makes data avail- 
able to the VAXmate CPU, the keyboard-interface controller updates the status 
register to reflect the current status. 


Pulse Output Port (FOH-FFH) 

The keyboard-interface controller pulses bits 3-0 of port 2 according to the 
value of bits 3-0 of the command value. Any of the bits 3-0 that are clear in 
the command byte are pulsed low for approximately six microseconds. 


All four bits (3-0) are affected by this command, but bits 3-2 are not connected 
to anything. Bit 1 gates the address line A20. Bit 0 is connected to the 
VAXmate CPU reset circuitry. The ROM BIOS uses this command to return 
to real mode from virtual protected mode. 
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Keyboard-Interface Controller Error Handling 


If the LK250 keyboard initiates a transmission sequence and the data is re- 
ceived with a parity error, the keyboard-interface controller issues a resend 
command. If the response to the resend command is bad, the keyboard- 
interface controller places an FFH code in the output buffer and sets the parity 
error bit in the status register. 


If the keyboard-interface controller cannot start a transmission within 15 milli- 
seconds or it cannot complete a transmission within two milliseconds after it 
was started, the transmit timeout bit is set in the status register and an FEH 
(keyboard resend request) is placed in the output buffer. 


If the LK250 keyboard does not respond within 20 milliseconds, then the 
transmit timeout bit and receive timeout bit are set in the status register. If 
the LK250 keyboard response was received with a parity error, then the 
transmit timeout bit and the parity error bit are set in the status register and 
an FEH (keyboard resend request) is placed in the output buffer. 


If the keyboard-interface controller has not inhibited the keyboard and a LK250 
keyboard transmission does not complete within two milliseconds after it is 
started, the receive timeout bit is set in the status register. A resend command 
is not issued by the keyboard-interface controller. 
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LK250 Keyboard 


Sean Codes 


When a key is pressed, the LK250 keyboard transmits a value, in the range 
01H-99H, that identifies the pressed key. This value is known as a scan code. 
If the key is held down for a time that exceeds the autorepeat delay time, the 
keyboard repeatedly transmits the scan code at the autorepeat rate. When a 
key is released, the LK250 keyboard transmits a release code of FOH followed 
by the scan code of the released key. 


The LK250 keyboard transmits scan codes to the keyboard-interface controller. 
interface controller transmits the scan code or release code (FOQH) and scan 
code without conversion. If the keyboard-interface controller is in translate 
mode, the keyboard-interface controller converts the LK250 scan code or re- 
lease code (FOH) and scan code to an industry-standard 1-byte value. In the 
industry-standard representation, a released key is indicated by adding 80H to 
the translated scan code value. 


Table 8-5 lists the LK250 scan codes, their equivalent keyboard-interface- 
controller translated industry-standard value, and keyboard location label. 
Figure 8-1, a representation of the LK250 keyboard, shows location labels for 
each key position. 


Table 8-6 lists values in the scan code range (01H-99H) that the LK250 key- 
board does not use to represent keys. However, in translate mode, the 
keyboard-interface controller translates them to the indicated industry-standard 
value. 
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Figure 8-1 Keyboard Position Labels 
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Table 8-5 LK250 Scan Codes and Industry-Standard Equivalent Value 


onan uaniesenensi neni aur ointment Maen gino NMRA Rtn metre ao roaring 


LK250 Translated Keyboard Key Name 
Scan Industry-Standard Position 

Code Scan Code 

O1H 43H G08 Fg 
03H 3FH G03 F5 
04H 3DH GO1 F3 


05H 3BH Cr99 Fl 
06H 3CH GOO F2 
09H 44H G09 F10 
OAH 42H G07 F8 


OBH 40H G05 F6 
OCH 3EH G02 F4 
ODH OFH DOO Tab 
OEH 29H BOO " 


| 38H AQ9 Alt 

12H 2AH B99 Left Shift 
| 1DH C99 Ctrl 

15H 10H 


I 

16H 02H E 
H 2CH BO 
H 1FH CO. . 
H 1EH COl aA 


vgn rrr iene eet erento eninge 


DO1 q Q 


V 
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Table 8-5 LK250 Scan Codes and Industry-Standard Equivalent Value (cont.} 


LK250 Translated Keyboard Key Name 
Sean Industry-Standard Position 
Code Sean Code 


2 DE L 13H D04 pon 

2EH 06H E05 5 % 
31H 31H BO6 nN 
32H 30H BO5 b B 
33H 23H C06 h H 
34H 22H C05 eG 
35H 15H DO06 y Y 
36H O7H E06 6° 


3AH 32H B07 m M 
3BH 24H COT e 

3CH 16H D07 u U 
3DH 08H E07 7 & 


3H 09H B08 8 * 
41H 33H BO8 , = 
42H 25H C08 k K 
43H 17H DO08 i 


44H 18H DO9 o O (Letter) 
45H OBH E10 Q ) 

46H OAH E09 es 

49H 34H BO9 .> 


4AH 35H B10 |? 
4BH 26H C09 IL 
4CH 27H C10 = 
4DH 19H D10 p P 


4EH OCH I 
52H 28H ( 
54H 1AH I 
55H 0DH E 
58H 3AH C00 Lock 

59H 36H Bll Right | Shift 
5AH 1CH ( Re 
5BH 1BH I |! 
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Table 8-5 


Sean 


Code 


mtorr inti nanneigann ~ 


5DH 
66H 
69H 
6BH 


6CH 
70H 
71H 
72H 
73H 
74H 
75H 
76H 


T7H 
79H 
TAH 
7BH 
7CH 
7DH 
TEH 
7FH 
83H 
84H 
85H 
86H 


87H 
88H 
89H 
8AH 


8BH 
8CH 
8DH 
8EH 


Translated 
Industry-Standard 
Scan Code 


inion 


2BH 
OEH 
4FH 
4BH 
47H 
52H 
53H 
50H 
4CH 
4DH 
48H 
O1LH 
45H 
4EH 
51H 
4AH 


37H 
49H 
46H 
54H 


41H 
04H 
55H 
56H 


07H 
58H 
59H 
5AH 


5BH 
5CH 
5DH 
5bEH 


Keyboard 
Position 


E12 
E13 
B20 
C20 
D20 
A20 
A22 
B21 
C21 
C22 
D21 
E20 
E21 
C23 
B22 
D23 
E23 
D22 

522 


SomocousontceseNsntose 


G06 
G23 
E16 
E17 


£18 
D16 
D17 
D18 
C17 
B16 
B17 
B18 
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stoner 


Lanner 


tno 


Key Name 


sects sinners neni taste eae enearinttnmnnreselin myn nein tine irinentinunineontorarrenmct 


\ | 

Delete (Word/Char} 
1 End 

4 Left-Arrow 


7 Home 

Q Ins 

. Del 

2 Down-Arrow 


9 

6 Right-Arrow 
8 Up-Arrow 
Ese 


NumLock 
+ (Keypad) 
3 PgDn 

- (Keypad) 


PrtSc * 

9 PgUp 
ScriLock Break 
SysReq (Alt/F20) 


F7 

F20 

Find 

Insert Here 


Remove 
Select 
Prev 
Next 


Up-Arrow 
Left-Arrow 
Down-Arrow 
Right-Arrow 
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Table 8-5 LK250 Scan ee and sneustTy prancend Pavalent Value (cont. ) 
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LK250 Tr | Kesbonra: Key Namie 
Scan Industry-Standard Position 
Code Scan Code 


tenneoereanetensasneecceese ties SNS SSS IPOH EE AD aN Seer eer RUSS senses i ee astra ei 


8FH 5FH Gil FI 

90H 60H 412 F12 

91H 61H G13 F13 
92H 62H 414 Fl4 
93H 63H G15 Help 
94H 64H G16 Do 

95H 65H G20 F17 
96H 66H G21 F18 


97H 67H G22 F19 
98H 68H E00 Compose 
99H 69H A2: Enter Useypee) 


See SNE SR HEE NYASSA SINS SLS SESS SAAS AC SUAS SASS OSSD SAU rt aC AON SANE TOLEDO AES A CELESTE TEED D NMI P VEL IR AEN LALA LSS NAN SMELLY ANNN LASHES 
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Table 8-6 Scan Codes Translated But Not Used 

“iil” Unused Translated Unused Translated 
Scan Industry-Standard Sean Industry-Standard 
Code Sean Code Code Scan Code 


aeons tterenmnemanemenenaei 


02H 41H 51H 73H 
07H 58H 53H 74H 
08H 64H 56H 62H 
OFH 59H 57H 6EH 
10H 65H 5CH 75H 
13H 70H 5EH 63H 
17H 5AH 5FH 76H 
18H 66H 60H 55H 
19H 71H 61H 56H 
1FH 5BH 62H 77H 
20H 67H 63H 78H 
27H 5CH 64H 79H 
28H 68H 65H 7AH 
2FH 5DH 67H 7BH 
30H 69H 68H 7CH 
37H 5EH 6AH 7DH 
38H 6AH 6DH 7EH 
39H 72H 6EH 7FH 
3FH 5FH 6FH 6FH 
40H 6BH 78H 57H 
47H 60H 80H 80H 
48H 6CH 81H 81H 
4FH 61H 82H 82H 
50H 6DH es 
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LK250 Keyboard Command Codes 


Table 8-7 provides a summary of the LK250 command codes, Following Table 
8-7 are descriptions of each command. The command descriptions give the pur- 
pose of the command, the actions taken by the keyboard, and the response 
code transmitted by the LK250 keyboard. The LK250 keyboard response codes 
are described later in this chapter. 


Table 8-7 LK250 Keyboard Command Codes 


iments nano} snhaiiiiniinasasonerusniis mina si ssi cassis oneness Ermey ¥ nent inane Noe 


Value Description 


Wenonah insinuate totoesihinanni isis non " i i acta easton eee etc rR 


00H-AAH Invalid Commands 
ABH Request Keyboard ID (Digital Extended) 
ACH Enter Digital Extended Scan Code Mode 
ADH Exit Digital Extended Scan Code Mode 
AEH Set Keyboard LED (Digital Extended) 
AFH Reset Keyboard LED (Digital Extended) 
BOH Set Keyclick Volume (Digital Extended) 
Bint Enable Autorepeat 

B2H Disable Autorepeat 

B3H Keyboard Mode Lock 

B4H Keyboard Mode Unlock 

B5H-ECH Reserved 

EDH LEDs On/Off 

EEH Echo 

EFH-F2H Reserved 

F3H Set Autorepeat Delay and Rate 


F4H Enable Key Scanning 

F5H Disable Key Scanning and Restore to Defaults 
F6H Restore To Defaults 

F7H-FDH Reserved 

FEH Resend 

FFH Reset 


_ prereset siti tannin sinensis rnin sims annette asin il naan ie onl SISA NSS iit ion aeandaienanteneninontemsainnaaitnroionnsiateananeivnnu 
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Invalid Commands (QOQH-AAH) 


When the LK250 keyboard receives a code in the range OOH-AAH, it transmits 
a resend request. The LK250 keyboard does not transmit an acknowledge 
(ACK) for codes in this range. 


Request Keyboard ID (ABH) 
DIGITAL Extended 


When the LK250 keyboard receives the code ABH, the keyboard clears its 
output buffer and transmits a 2-byte response that identifies the version and 
mode of the LK250 keyboard. The first byte returned is the version number, 
The second byte is the current operating mode, 01H for industry-standard 
mode or 02H for DIGITAL extended mode. 


To successfully execute this command, the keyboard-interface controller must 
be in pass-through mode. Otherwise, the keyboard controller attempts to 
translate the data to an industry-standard scan code. 


The LK250 keyboard does not transmit an acknowledge (ACK) for this 
command, 


Enter DIGITAL Extended Scan Code Mode (ACH) 
DIGITAL Extended 


When the LK250 keyboard receives the code ACH, the keyboard enables 
DIGITAL extended mode, turns off LED #4, and transmits an acknowledge 
(ACK), 


Exit DIGITAL Extended Scan Code Mode (ADH) 
DIGITAL Extended 


When the LK250 keyboard receives the code ADH, the keyboard enables 
industry-standard mode, turns on LED #4, and transmits an acknowledge 
(ACK). 


In this mode, only industry-standard scan codes are generated. 


Set Keyboard LED (AEH) 
DIGITAL Extended 


When the LK250 keyboard receives the code AEH, the keyboard turns on LED 
#4, and transmits an acknowledge (ACK). For LEDs 1-3, see LEDs On/Off 
(EDH). 
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Reset Keyboard LED (AFH) 
DIGITAL Extended 


When the LK250 keyboard receives the code AFH, the keyboard turns off LED 
#4, and transmits an acknowledge (ACK). For LEDs 1-3, see LEDs On/Off 
(EDH). 


Set Keyclick Volume (BOH) 
DIGITAL Extended 


This is a 2-byte command consisting of a command byte and a value byte. 
When the LK250 keyboard receives the code BOH, the keyboard stops scanning 
for keys, transmits an acknowledge (ACK), and waits for the second byte. 
When the LK250 keyboard receives the second byte, the keyboard sets the 
volume to the indicated value, transmits an acknowledge (ACK) and returns to 
the previous scanning state. 


If bit 7 of the value byte is set to 1, the value is interpreted as a command. 
The current command is aborted, the new command is executed and the LK250 
returns to the previous scanning state. 


The volume value byte can have one of the following values: 


Value Volume 


“sana nedonseesena aHOnsacerenin senator omneraeie nner hc yee AAD eSSA AUK sR) YASRON BASSAS HOSED NERA REORDER tie sins 


00H No keyclick 
02H Soft 

04H Medium 
06H Loud 


‘examen one Annie igonennonnaon enews ies DRS ent ns ti Hee ila A Uae EDDA tei ess DD mc ORS SHA ise Os oun Neem 


Enable Autorepeat (B1H) 
DIGITAL Extended 


repeat for all keys and transmits an acknowledge (ACK). Autorepeat enabled is 
the default condition. 


When the LK250 keyboard receives the code B1H, the keyboard enables auto- 
I 


Disable Autorepeat (B2H) 
DIGITAL Extended 


When the LK250 keyboard receives the code B2H, the keyboard disables auto- 
repeat for all keys and transmits an acknowledge (ACK), 
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Keyboard Mode Lock (B3H) 
DIGITAL Extended 


When the LK250 keyboard receives the code B3H, the keyboard disables the 
key combination ALT/F17 and transmits an acknowledge (ACK). The key com- 


Keyboard Mode Unlock (B4H) 
DIGITAL Extended 


When the LK250 keyboard receives the code B4H, the keyboard enables the 
key combination ALT/F17 and transmits an acknowledge (ACK). The key com- 
bination ALT/F17 toggles the keyboard between DIGITAL extended mode and 
industry-standard mode. This key combination is detected and handled by the 
keyboard, not the ROM BIOS. ALT/F17 enabled is the default condition. 


Reserved (B5H-ECH) 
DIGITAL Extended 


When the LK250 keyboard receives any of the reserved codes B5H-ECH, the 
keyboard transmits an acknowledge (ACK) and resumes its previous scanning 
state. 
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LEDs On/Off (E DH) 
DIGITAL Extended 


This is a 2-byte command consisting of a command byte and a value byte. 
When the LK250 keyboard receives the code EDH, the keyboard stops scan- 
ning for keys, transmits an acknowledge (ACK), and waits for the second byte. 
When the LK250 keyboard receives the second byte, the keyboard sets the 
LEDs to the indicated value, transmits an acknowledge (ACK) and returns to 
its previous scanning state. 


If bit 7 of the value byte is set to 1, the value is interpreted as a command. 
The current command is aborted, the new command is executed and the LK250 
returns to the previous scanning state. 


The bits in the LED value byte have the following meanings: 


Bit Description 
7-3 OB Reserved: always 0 
2 CapsLock 
0 = CapsLock LED off 
1 = CapsLock LED on 
1 NumLock 
QO = NumLock LED off 
1 = NumLock LED on 
0 Scroll Lock 


0 = Scroll Lock LED off 
1 = Scroll Lock LED on 


Echo (EEH) 


Industry-Standard 


When the LK250 keyboard receives the code EEH, the keyboard transmits the 
same echo code (EEH) and continues its previous scanning state. This com- 
mand is a diagnostic tool. 


Reserved (EF FH-F2H) 
Industry-Standard 
When the LK250 keyboard receives any of the reserved codes EFH-F2H, the 


keyboard transmits an acknowledge (ACK) and resumes its previous scanning 
state. 
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Set Autorepeat Delay and Rate (F3H) 


Industry-Standard 


This is a 2-byte command consisting of a command byte and a value byte. 
When the LK250 keyboard receives the code F3H, the keyboard stops scanning 
for keys, transmits an acknowledge (ACK), and waits for the second byte. 

When the LK250 keyboard receives the second byte, the keyboard sets the 
autorepeat delay and rate to the indicated values, transmits an acknowledge 
(ACK) and returns to its previous scanning state. 


If bit 7 of the value byte is set to 1, the value is interpreted as a command. 
The current command is aborted, the new command is executed and the LK250 


returns to the previous scanning’ state. 


The bits in the delay and rate value byte have the following meanings: 


Bit 


Description 


ostentatious 


7 


6-5 


4-() 


Autorepeat delay (+ 20%) 


00 = 
01 = 
10 = 
ll = 


Autorepeat rate (+ 


20%} 


Always 0 


Bits 4-0 


00000 
00001 
00010 
00011 
00100 
00101 
00110 
OOLLI 
01000 


01001 - 


01010 
O1011 
01100 
O11L01 
01110 
O1111 


ere 
sii, 


soars 


.25 seconds 
.5 seconds 
.75 seconds 
1.0 second 


Rate per second 


29.98 
26.65 
23.98 
21.80 
19.98 
18.45 
Licks 
15.99 
14.99 
13.32 
£1.99 
10.90 

v9 

9.22 

8.56 

199 


Bits 4-0 


10000 
10001 
10010 
10011 
10100 
10101 
10110 
10111 
11000 
11001 
11010 
11011 
11100 
11101 
11110 
11111 
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Rate per second 


7.49 
6.66 
6.00 
5.45 
5.00 
4.61 
4,28 
4.00 
3.75 
3.33 
3.00 
2.73 
2.50 
2.31 
2.14 
2.00 
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RUNG 


Enable Key Scanning (F4H) 
Industry-Standard 


When the LK250 keyboard receives the code F4H, the keyboard clears its 
output buffer, transmits an acknowledge (ACK), and begins scanning for keys. 
Use of this command assumes that key scanning was previously disabled. Any 
key strokes that were recognized but not transmitted are lost. 


Disable Key Scanning and Restore to Defaults (F5H) 


Industry-Standard 


When the LK250 keyboard receives the code F5H, the keyboard stops scan- 
ning, clears its output buffer, restores conditions to the default powerup state, 
transmits an acknowledge (ACK), and waits for additional commands. Keyboard 


transmitted are lost. 


Feature Default 
Autorepeat delay .5 seconds 
Autorepeat rate 29.98 per second 
ALT/F17 mode toggle Enabled 

LEDs Off 

Digital extended mode Disabled 


Restore To Defaults (F6H) 


Industry-Standard 


When the LK250 keyboard receives the code F5H, the keyboard stops scan- 
ning, clears its output buffer, restores conditions to the default powerup state, 
transmits an acknowledge (ACK), and resumes its previous scanning state. 


Feature Default 
Autorepeat delay .5 seconds 
Autorepeat rate 29.98 per second 
ALT/F17 mode toggle Enabled 

LEDs Off 

Digital extended mode Disabled 
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Reserved (F7H-FDH) 
Industry-Standard 


When the LK250 keyboard receives any of the reserved codes F7H-FDH, the 
keyboard transmits an acknowledge (ACK) and resumes its previous scanning 
state. 


Resend (FEH) 


Industry-Standard 


When the LK250 keyboard receives the code FEH, the keyboard repeats its 
last transmission, This command is used when the keyboard-interface controller 
detects a reception error. It can be sent only in response to a transmission 
from the LK250 keyboard. Additionally, the resend command (FEH) must be 
transmitted before the keyboard-interface controller allows the keyboard to 
start another transmission. If the retransmitted data is still bad, the keyboard- 
interface controller places FFH in its output buffer and sets the parity error 
and timeout error status bits. 


Reset (FFH) 


Industry-Standard 


When the LK250 keyboard receives the code FFH, the keyboard transmits an 
acknowledge (ACK) and waits for the the acknowledge to be accepted. Receipt 
of the acknowledge (ACK) is indicated by reading the acknowledge (ACK) from 
the keyboard-interface controller, setting port 2 bits 7-6 to 1, and leaving them 
set for at least 500 us. When the keyboard recognizes acceptance of the ac- 
knowledge (ACK), the keyboard invokes its self-test diagnostic. On completing 
the self-test, the keybeard transmits AAH (self-test success) or FCH (self-test 
failure). As a result of the self-test, the keyboard is reset to default conditions 
and the keyboard output buffer is empty. 


Feature Default 
Autorepeat delay .5 seconds 
Autorepeat rate 29.98 per second 
ALT/F17 mode toggle Enabled 

LEDs Off 

Digital extended mode Disabled 
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LK250 Keyboard Responses 


The LK250 keyboard must reply to every transmission sent to it. Most of the 
time the reply is an acknowledge (ACK), but some commands have special 
responses. Refer to LK250 keyboard command descriptions for details. Table 
8-8 lists the LK250 keyboard responses. 


Table 8-8 LK250 Keyboard Responses 


cannes ini OS ii ees inal asinine see einstein eee MHRA EB re DA Pe ieee ie ea ree eT 


Value Description 
00H Buffer Overrun 


AAH Self-Test Success 

EEH ECHO 

FAH Acknowledge (ACK) 

FCH Power-Up Self-Test Failure 
FDH Not Used 

FEH Resend 
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Buffer overrun (OOH) 


This code indicates that the L.K250 keyboard output buffer (20 bytes) has been 
filled to capacity (19 key codes) and an attempt was made to store another 
code. The 20th code is replaced with OOH. 


If the keyboard-interface controller is in translate mode, the LK250 keyboard 
buffer-overrun code QOH is translated to an industry-standard buffer overrun 
code of FFH. 


Self-test success (AAH) 
Industry-Standard 


This code indicates successful completion of the LK250 keyboard self-test diag- 
nostics. The self-test diagnostics are invoked as part of the powerup sequence 
and by the reset command (FFH). 


ECHO (EEH) 
Industry-Standard 


This code indicates receipt of an echo command (EEH). In response to an echo 
command (EEH), the LK250 transmits echo (KEH) instead of acknowledge 
(ACK) (FAH). 
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Release Prefix (FQH) 
Industry-Standard 


This code indicates that a key was released. It is followed by the scan code of 
the released key. 


If the keyboard-interface controller is in translate mode, this 2-byte sequence is 
translated to an industry-standard 1-byte release code by adding 80H to the 
translated scan code. 


Acknowledge (ACK) (FAH) 


Industry-Standard 


This code is transmitted by the LK250 keyboard in response to most of the 
valid commands. Some commands have special responses. For example, request 
keyboard identification (ABH), echo (EEH), and resend (FEH). For additional 
information, see the descriptions of the LK250 keyboard commands. 


Self-Test Failure (FCH) 

Industry-Standard 

This code transmitted by the LK250 keyboard to indicate that a keyboard com- 
ponent failed the self-test diagnostics. Self-test is invoked during the powerup 
sequence and the reset command (FFH). 


Resend (FEH) 


Industry-Standard 


This code is transmitted by the LK250 keyboard in response to a keyboard- 
interface controller transmission containing a parity error. Providing that the 
last transmission to the keyboard was not a resend command (FEH), the key- 
board interrupt handler should retransmit the last keyboard command. 


LK250 Keyboard Error Handling 

If the LK250 keyboard receives an invalid command or a parity error, it replies 
with a resend command. 

U.S. and Foreign Keyboards 


The LK250 keyboard is shipped with key legends appropriate for the destina- 
tion country. Figure 8-2 through Figure 8-15 show the key legends for the 
various country keyboards. 
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Figure 8-2 U.S./U.K. Keyboard 
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Figure 8-4 Danish Keyboard 
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Figure 8-5 
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Figure 8-6 
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French Keyboard 


Figure 8-7 
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Figure 8-8 


sion 


t 


* 


scrip 


Keyboard-Interface Controller - Hardware De 


38 


s 
m 


8 


Figure 8-9 Hebrew Keyboard 
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Figure 8-10 
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Figure 8-11 Norwegian Keyboard 
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Figure 8-12 Spanish Keyboard 


8- 42 Keyboard-Interface Controller - Hardware Description 


geso-ry 


a 


oe ee eee, ee 
lie wii DY ai OL HEL API LAI IL yl PLM) OF) om) 
ated occa Gacruen Gerives Moe ae eee ee oft Ciao ‘fon So 


‘ i ‘ aw M 
(hal lasethraahoah 


ile eile) | A siiiegile 1) 


aa tig: 3] ag Sc eee i + 3 H ifs pid i 
Lewd | os pb iS  aairrrmeree a ig nemo Oy Oy Silene GO deeb Dae Oy Cusemenle Or ag Neilinnmets Os Stoney Oe Op Sanne Oe Se | 
i ; i i 7 7 { ; q 


8- 43 


Figure 8-13. Swedish Keyboard 
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Figure 8-14 Swiss/French Keyboard 
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Swiss/German Keyboard 


Figure 8-15 
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Programming Example 


The subroutines in the keyboard example provide keyboard input support for all 
of the examples in this manual. The keyboard example demonstrates: 


* Communicating with the keyboard-interface controller 
e The use of keyboard translation tables 
e Extended features of the LK250 keyboard 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


The example provides routines as described in the following list. 

wr_kcc Writes a command byte to the keyboard-interface controller 
wr_ked Writes a data byte to the keyboard-interface controller 
pass_thru Sets the keyboard-interface controller to pass-through mode 
kyb_ init Prepares the interrupt structure for keyboard interrupts 
wr_kyb Places data in a ring buffer for output to the keyboard 

kyb_ led Turns LEDs on or off according to the keyboard state 

kyb_ send Retrieves data from a ring buffer and writes it to the keyboard 
kyb_ rest Restores the previous keyboard interrupt structure 

get key xets a 1-byte value from the keyboard input ring buffer 


kyb int hand Handles keyboard-interface-controller interrupts and performs 
scan code translations 


kyb_ exm Provides an example environment for examining various aspects 
of the keyboard 
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#include "rb.h" 
#include "example.h" 


JORIS OO OSC OIG ii kk kk kk I SOIC ge de ak ae ak ak ak ak ak ak ake ke ake ake ake ake ake / 


/* define constants and structures used in keyboard examples 


+/ 
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#define COMMAND 0x64 /* command register in I/O space 
#define DATAREG 0x60 /* data register in I/O space 


/* define mask bits for keyboard state flag */ 


#define S_LSHF Ox01 /* left shift key is pressed * 
#define S_RSHF 0x02 /* right shift key is pressed 
#define S_CTRL 0x04 /* control key is pressed 
#define S_ALT 0x08 /* Alternate key is pressed 
#define S_SCRL 0x10 /* Scroll lock is in effect 
#define S_NUM 0x20 /* Numerics lock is in effect 
#define S_CAPS 0x40 /* Caps lock is in effect 
#define S_INS 0x80 /* Insert mode is active 


/* define modifier-key values returned by keyboard */ 


#define CTRL Oxid /* control key 
#define LSHF Ox2a /* left shift key - 
#define RSHF 0x36 /* right shift key » 
#define ALT 0x38 /* alternate key 
#define CAPS Ox3a /* Lock/Caps Lock key 
#define NUML 0x45 /* NumLock key * 
#define SCRL 0x46 /* ScrlLock key 
#define INS Ox52 /* Ins (Insert) key 
#define DEL 0x53 /* Del key 


/* define some keyboard interface controller commands */ 


#define RDCB 0x20 /* read command byte 
#define WRCB 0x60 /* write command byte 


*/ 
*/ 


*/ 
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/* define some keyboard commands */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


LED123 
LED4_ON 
LED4_OF 
ENT_EXM 
EXT_EXM 
AREPON 
AREPOFF 
SETAR 
SETVOL 
KYBID 
RESDEF 


Oxed 
Oxae 
Oxaf 
Oxac 
Oxad 
Oxbi 
Oxb2 
Oxf3 
OxbO 
Oxab 
Oxf6 


/* control leds 1,2, 
/* turn led 


/* turn led #4 off * 

/* enter DIGITAL extended keyboard mode 
/* exit DIGITAL extended keyboard mode * 
/* auto-repeat on * 

/* auto-repeat off 
/* set auto-repeat rate * 
/* set speaker volume : 
state * 


/* return keyboard ID and 


and 3 * 


#4 on 


/* reset keyboard to default values 


/* define some keyboard responses */ 


#define B_FULL 0x00 
#define RESEND Oxfe 


#define 


ACK 


Oxfa 


/* keyboard buffer full * 


/* request to resend command or data 
/* keyboard acknowledge 


/* define some state dependent keyboard table index constants */ 
/* Note: The ROM BIOS has separate alpha and numeric tables. */ 
This example combines the alpha and numeric tables. */ 


/* 


#define 
#define 
#define 
#define 
#define 


#define 
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T_NORM 
TIALT 
TUCTRL 
T_SHFT 
T_A_N 


KB_STZ 


0x00 
0x02 
0x04 
0x06 
0x08 


128 


/* look in normal key 

/* look in alternate combination 
/* look in control key 

/* look in shift 

/* look in alphanumeric 


/* example keyboard buffer size is 128 
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table 
table 
table 
table 


bytes 


*/ 
/ 
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/* define key translation tables and variables 


“/ 


[OO IO ORO kok i kok kok a ok ke ak ak ak ak ok ak ak ake ake okie ake akc ak ake aks ok akc akc oka ake ake oe ke ake ate ake / 


unsigned char kyb_state; /* state of modifier keys */ 
unsigned char last_send; /* last character sent to keyboard */ 
unsigned char key_buff[2] [KB_SIZ]; /* place to store incoming keys */ 
unsigned char released; /* last released key for demo */ 
unsigned char depressed; /* last depressed key for demo */ 
RING_BUFF ki_rb; /* ring buffer control structure */ 
RING_BUFF ko_rb; /* ring buffer control structure */ 
/* define the keyboard tables */ 

/* Note: The ROM BIOS has separate alpha and numeric tables. */ 

/* This example combines the alpha and numeric tables. */ 

static unsigned char keyboard[0x70][9] = 

{ 

/* NORMAL | ALT | CONTROL | SHIFT | A/N */ 

Oxtf, Oxit, Oxff,. Oxti, Oxtt, Oxti,. Oxtt, Oxftf, Oxti, /* overrun */ 
Oxib, Ox01, Oxff, Oxff, Oxib, Ox01, Oxib, Ox01, 0x00, /* ESC */ 
0x31, 0x02, 0x00, 0x78, Oxff, Oxff, 0x21, 0x02, 0x00, /* 1 */ 
0x32, 0x03, 0x00, 0x79, 0x00, 0x03, 0x40, 0x03, 0x00, /* 2 */ 
0x33, 0x04, Ox00, Ox7a, Oxff, Oxff, 0x23, 0x04, 0x00, /* 3 */ 
0x34, 0x05, 0x00, Ox7b, Oxff, Oxff, 0x24, 0x05, 0x00, /* 4 */ 
0x35, 0x06, 0x00, Ox7c, Oxff, Oxff, 0x25, 0x06, 0x00, /* & */ 
0x36, 0x07, Ox00, Ox7d, Oxle, 0x07, OxS5e, 0x07, 0x00, /* 6 */ 
0x37, 0x08, 0x00, Ox7e, Oxff, Oxff, 0x26, 0x08, Ox00, /* 7 */ 
0x38, 0x09, 0x00, Ox7f, Oxff, Oxff, Ox2a, 0x09, 0x00, [* 8 */ 
0x39, OxOa, 0x00, 0x80, Oxff, Oxff, 0x28, Ox0Oa, 0x00, /* 9 x«/ 
0x30, OxOb, 0x00, Ox81, Oxff, Oxff, 0x29, OxOb, 0x00, /* 0 */ 
Ox2d, OxO0c, Ox00, 0x82, Ox1f, OxOc, Ox5f, OxOc, 0x00, [x - «/ 
Ox3d, OxOd, 0x00, 0x83, Oxff, Oxff, Ox2b, OxOd, 0x00, /*x = «f/f 
0x08, OxOe, Oxff, Oxff, Ox7f, OxO0e, 0x08, Ox0e, 0x00, /* BS */ 
0x09, OxOf, Oxff, Oxff, Oxff, Oxff, 0x00, OxO0f, 0x00, /* TAB */ 
Ox71, 0x10, 0x00, 0x10, 0x11, 0x10, Ox5i, 0x10, S_CAPS, /* Q */ 
Ox77, Ox11, 0x00, Oxi1, Ox17, Ox11, 0x57, Ox11, S_CAPS, /* W */ 
0x65, 0x12, 0x00, 0x12, 0x05, 0x12, 0x45, 0x12, S_CAPS, /* E «/ 
0x72, 0x13, 0x00, 0x13, 0x12, 0x13, Ox52, 0x13, S_CAPS, /* R */ 
0x74, Oxi4, 0x00, Ox14, 0x14, 0x14, 0x54, 0x14, S_CAPS, /* T */ 
0x79, Oxi5, 0x00, Oxi5, 0x19, Oxi5, 0x59, Ox1i5, S_CAPS, fx Y */ 
0x75, 0x16, 0x00, 0x16, 0x15, Oxi6, 0x55, 0x16, S_CAPS, /* U */ 
0x69, Ox17, Ox00, Ox17, 0x09, 0x17, Ox49, Ox17, S_CAPS, /* I */ 
Ox6f, 0x18, Ox00, 0x18, OxOf, 0x18, Ox4f, 0x18, S_CAPS, /* 0 */ 
0x70, Ox19, 0x00, 0x19, 0x10, 0x19, Ox50, 0x19, S_CAPS, /* P «/ 
Ox5b, Oxia, Oxff, Oxff, Oxib, Oxia, Ox7b, Oxia, 0x00, /* [ */ 
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Ox5d, Oxib, Oxff, 
OxOd, Oxic, Oxff, 
Oxff, Oxff, Oxff, 
Ox61, Oxlie, Ox00, 
0x73, Oxif, 0x00, 
0x64, 0x20, Ox00, 
0x66, Ox21, 0x00, 
Ox67, Ox22, 0x00, 
0x68, Ox23, 0x00, 
Ox6a, Ox24, 0x00, 
Ox6b, Ox25, 0x00, 
Ox6c, 0x26, 0x00, 
Ox3b, Ox27, Oxff, 
Ox27, 0x28, Oxff, 
Ox60, 0x29, Oxff, 
Oxft; Oxvit, Oxtf, 
Ox5c, Ox2b, Oxff, 
Ox7a, Ox2c, 0x00, 
0x78, Ox2d, 0x00, 
0x63, Ox2e, 0x00, 
Ox76, Ox2f, 0x00, 
0x62, Ox30, Ox00, 
Ox6e, Ox31, Ox00, 
Ox6d, 0x32, 0x00, 
Ox2c, 0x33, Oxff, 
Ox2e, 0x34, Oxff, 
Ox2t, 0x36; Oxtf, 
Oxff, Oxff, Oxff, 
Ox2a, Ox37, Oxff, 
Oxff, Oxff, Oxff, 
0x20, 0x39, Ox20, 
Oxff, Oxff, Oxff, 
0x00, Ox3b, 0x00, 
0x00, Ox3c, 0x00, 
0x00, Ox3d, 0x00, 
0x00, Ox3e, Ox00, 
0x00, Ox3f, 0x00, 
0x00, 0x40, 0x00, 
0x00, Ox41, 0x00, 
0x00, 0x42, 0x00, 
0x00, 0x43, 0x00, 
0x00, 0x44, 0x00, 
Oxff, Oxff, Oxff, 
Oxff, Oxff, Oxff, 
0x00, 0x47, 0x07, 
0x00, 0x48, 0x08, 
0x00, Ox49, OxO9, 
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Oxff, 
Oxff, 
OxTT 
Oxie, 
Oxif, 
0x20, 
Ox21, 
0x22, 
0x23, 
Ox24, 
0x25, 
0x26, 
Oxi t.. 
Oxts 
Oxff, 
Oxtt, 
Oxtt; 
Ox2c, 
Ox2d, 
Ox2e, 
OxZi. 
0x30, 
Ox31, 
0x32, 
Oxff, 
OxEt, 
Oxff, 
Oxff, 
Oxff, 
Oxff, 
0x39, 
Oxff, 
0x68, 
0x69, 
Ox6a, 
Ox6b, 
Ox6c , 
Ox6d, 
Ox6e, 
Ox6f , 
0x70, 
Ox71, 
Oxff, 
Oxf f , 
0x00, 
0x00, 
0x00, 


Oxid, Oxib, Ox7d, 
OxOa, Oxic, OxOd, 
Oxti, Oxit, Oxtf, 
0x01, Oxie, Ox4i, 
Oxi3, Oxlf, Ox52, 
0x04, Ox20, 0x44, 
0x06, Ox21, Ox46, 
0x07, Ox22, Ox47, 
0x08, Ox23, 0x48, 
OxOa, 0x24, Ox4a, 
OxOb, 0x25, Ox4b, 
OxOc, 0x26, Ox4c, 
Oxff, Oxff, Ox3a, 
OxTL , ORIEL, Ox22; 
Oxff, Oxff, Ox7e, 
Ost? ,. Oxit, Oxi. 
Oxic, Ox2b, Ox7c, 
Oxla, Ox2c, OxSa, 
0x18, Ox2d, Ox58, 
0x03, Ox2e, 0x43, 
0x16, Ox2f, 0x56, 
0x02, 0x30, 0x42, 
OxO0e, Ox31, Oxd4e, 
OxOd, 0x32, Ox4d, 
Oxstt, Oxtt. Oxac, 
Oxff, Oxff, Ox3e, 
Oxtt.. Oxit,, Ox3t,, 
Oxff, Oxff, Oxff, 
0x00, Ox72, Oxff, 
Oxff, Oxff, Oxff, 
0x20, 0x39, Ox20, 
Oxit?;, -Oxit, :Oxtt ; 
0x00, OxS5e, 0x00, 
0x00, Ox5f, 0x00, 
0x00, 0x60, 0x00, 
0x00, Ox61, 0x00, 
0x00, 0x62, 0x00, 
0x00, 0x63, 0x00, 
0x00, 0x64, 0x00, 
0x00, 0x65, 0x00, 
0x00, 0x66, 0x00, 
0x00, 0x67, Ox00, 
Oxff, Oxff, Oxff, 
0x00, 0x00, Oxff, 
0x00, Ox77, 0x37, 
Oxff, Oxff, 0x38, 
0x00, 0x84, 0x39, 


Oxib, 
Oxic, 
Oxf f , 
Oxle, 
Oxit. 
0x20, 
Ox21, 
0x22, 
0x23, 
0x24, 
0x25, 
0x26, 
Ox27, 
0x28, 
0x29, 
Oxtt. 
Ox2b, 
Ox2c, 
Ox2d, 
Ox2e, 
Ox2¢£ , 
0x30, 
0x31, 
0x32, 
0x33, 
0x34, 
0x35, 
Oxff , 
Oxff, 
Oxff, 
0x39, 
Oxf f , 
0x54, 
0x55, 
Ox56, 
Ox57, 
0x58, 
0x59, 
Ox5a, 
Ox5b, 
Ox5c, 
Ox5d, 
Oxf f , 
Oxff, 
0x47, 
0x48, 
0x49, 


0x00, 
0x00, 
0x00, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
S_CAPS, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
S_NUM, 
S_NUM, 
S_NUM, 


/3 
/+ 
/* 
| * 


“, 


/* ALT 


/* Space Bar * 
/* CAPS Lock * 
/* F1 


/* F2 


/* F3 * 


/* F4 


/* FB * 
/* F6 ° 
/* FT * 
/* FB * 


/* F9 


/* F10 * 
/* NumLock * 
ScrlLock * 
keypad 7 * 


keypad 8 


keypad 9 > 


~ 
¥ 
S20 << OM N 


Je [ * 
/* Right Shift * 
/* PRTSC * 


Ox2d, 
0x00, 
Oxff, 
0x00, 
Ox2b, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
Ox0Od, 
}; 


Ox4a, 
Ox4b, 
Oxff, 
Ox4d, 
Ox4e, 
Ox4f, 
0x50, 
Ox51, 
0x52, 
0x53, 
0x98, 
Ox85, 
Ox86, 
Ox87, 
0x88, 
0x89, 
Ox8a, 
Ox8b, 
Oxec: 
Ox8d, 
Ox8e, 
Ox8e£ , 
0x90, 
Ox91, 
0x92, 
0x93, 
0x94, 
0x95, 
0x96, 
0x97, 
Oxbd, 
Ox9a, 


Oxff, 
0x04, 
0x05, 
0x06, 
Oxff, 
Ox01, 
0x02, 
0x03, 
0x00, 
Oxff, 
Oxff, 
Oxf f , 
Oxff, 
Oxtt 
Oxtft, 
Oxff , 
Oxff, 
Oxff , 
OxT SL: 
Oxff, 
Oxff, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 


Oxff, 
0x00, 
0x00, 
0x00, 
Oxi ft. 
0x00, 
0x00, 
0x00, 
0x00, 
Oxf ft, 
Oxtt 
Oxt i , 
Oxff, 
Oxf f , 
Oxff , 
Oxff, 
Oxff, 
Oxff, 
Oxtt , 
Oxff, 
Oxff, 
Oxb3, 
Oxb4, 
Oxb5, 
Oxb6, 
Oxb7 , 
Oxb8, 
Oxb9, 
Oxba, 
Oxbb, 
Oxbd, 
Oxbe, 


Oxtt, 
0x00, 
Oxff, 
0x00, 
Oxff, 
0x00, 
Oxff, 
0x00, 
Oxff, 
Oxtt. 
0x00, 
Oxff, 
0x00, 
0x00, 
Oxit 
0x00, 
0x00, 
Oxff, 
0x00, 
0x00, 
Oxff, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 


Oxff, 
0x73, 
Oxff , 
Ox74, 
Oxff, 
0x75, 
Oxff, 
Ox76, 
Oxff, 
Oxtt, 
OxbO, 
Oxff, 
Oxc3, 
Oxct, 
Oxit; 
Oxc4, 
OxE2, 
OxTE. 
Oxbf , 
OxcO, 
Oxt?, 
Oxa7T, 
Oxa8, 
Oxad, 
Oxaa, 
Oxab, 
Oxac, 
Oxad, 
Oxae, 
Oxaf , 
Oxbd, 
Oxb2, 


Ox2d, 
0x34, 
0x35, 
0x36, 
Ox2b, 
Ox31, 
0x32, 
0x33, 
0x30, 
Ox2e, 
0x00, 
Oxff, 
Oxff, 
Oxff , 
Oxff, 
Oxff, 
Oxff, 
Oxff, 
Oxff, 
Oxff, 
Oxf f , 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
0x00, 
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Ox4a, 
Ox4b, 
Ox4c, 
Ox4d, 
Ox4e, 
Ox4f, 
0x50, 
Ox51, 
0x52, 
0x53, 
Oxa4, 
Oxff, 
Oxff, 
Oxtt; 
Oxff, 
Oxtt , 
OXLT. 
Oxff , 
Oxff , 
Oxff , 
Oxi, 
Ox9b, 
Ox9c, 
Ox9d, 
Ox9e, 
Ox9F , 
OxaO0, 
Oxal, 
Oxa2, 
Oxa3, 
Oxbd, 
Oxa6, 


/* keypad 
/* keypad 


/* keypad 
/* keypad . 


i 


/* keypad 
/* keypad 
/* keypad 
/* keypad 
/* keypad 
/* keypad 


Oaon&- + O 7 & 


/* F20 
/* FIND 
/* INSERT 


/* REMOVE » 


/* SELECT 
/* PREV 
/* NEXT 


/* Fi9 * 


/* COMPOSE 
/* ENTER 
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[DCC IO ICO SIO IIIS ISIC IGS IGIOI SI ICICI I ok aC Rok ak aC ake akc ak ok ok ake ake ak / 
/* wr_kec() - Write keyboard controller command + f 


wr_kec (cmd) 


unsigned char cmd; /* command byte to write */ 
{ 
outp(COMMAND, cmd); /* write command byte */ 
while((inp(COMMAND) & 0x02)) /* wait until KC has read command */ 


} 


/* wr_kcd() - Write keyboard controller data + / 


JRO III GO IG Gk a koko ok kako kak ak kok ok ak ake ake ak kook ak ak ake akc ak te oie a ote ate oka ak ake ak / 
wr_kcd(data) 
unsigned char data; /* data byte to write */ 


{ 


outp(DATAREG, data); /* write command data */ 
while((inp(COMMAND) & 0x02)) /* wait until KC has read data */ 
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“Guess a : 


JOO CRIOOI OOOO II IO Ok a kok 2k a ook ok ok ac ok ok ok ak akc ake akc akc akc ake ake ake ake ak ake ake ake ake / 


/* pass_thru() - set keyboard controller pass through mode * 


[Re RES af ois of ke ofc ofe okt oe ole oe oft ote oft ole oft ke ots oe le oie of ole ole obs fc oe of abe ole of os oft fe ole che abe oe ole obs abe af ofc ode aie obs ofc ake ae ole ole ops obs ofe of ae oe of ofc oie oie oe ole ste ok aoe / 


pass_thru(flag) 


int flag; /* if TRUE, set pass through */ 
/* else clear pass through */ 

{ 

unsigned char c; /* tmp to hold internal command byte */ 

unsigned int intr_flag; /* tmp to hold CPU IF state */ 


intr_flag = int_off(); /* turn interrupts off */ 
wr_kcc (RDCB) ; /* give me current command byte */ 
while(!(inp(COMMAND) & 0x01)) /* wait until output buffer full */ 


a 


c = inp(DATAREG) ; /* read command byte from data buffer */ 


if(flag) c &= ~0x40;/* if TRUE, do not decode keyboard transmissions */ 


else c |= 0x40; /* else, decode keyboard transmissions */ 
wr_kcc (WRCB) ; /* tell interface controller to write command byte */ 
wr_ked(c) ; /* send command byte to write */ 
int_on(intr_flag) ; /* allow interrupts */ 


} 


/* kyb_init() - keyboard interrupt initialization x / 
Jeo Oo oe ok ok ke ke ook ok ok feo ke oie oe ok ok ok oe oe ok eo ke ok ok che she the te Me de oe sie oe Ste she Sle Ae oe oe he okt he oe ole ke ake oe oe oe ie oe he oe oe she ok se ake kk a ok ok ok ok / 


kyb_init () 

{ 
kyb_state = 0; /* no states established */ 

/* establish ring buffers */ 

init_rb(&ki_rb, &key_buff[0][0], KB_SIZ, 30, 15); 
init_rb(&ko_rb, &key_buff[1][0], KB_SIZ, 30, 15); 
imask(0,1,0); /* disable PIC input for keyboard interface */ 
iv_init (0x09) ; /* keyboard interrupt is int 0x09 */ 
imask(0,1,1); /* enable PIC input for keyboard interface */ 
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/ SOOO IOS Sk kok ke dk a II IO IORI IO I ICICI aC a ae oko oka oc fe ofc ok ake ake ake ake ake ake ake ake ake ake ake ake ote ake ok / 


/* wr_kyb() - put value in output buffer to keyboard and start send * | 
JC OR kok kk iodo ok kok i kok Ca ak ok ak a oko ke ak ak ok ok lake ake ake ae ke ake ake a ak ode aie ote ake ake ofc ake ae oe akc ake ake ake ake ake ote te / 


wr_kyb(value) 

unsigned char value; /* value to send to keyboard */ 

{ 

unsigned intr_flag; /* to hold current CPU IF state */ 
intr_flag = int_off(); /* CPU interrupts off */ 
rb_in(&ko_rb, value); /* put value in ring buffer */ 
if(!last_send) kyb_send(0); /* if keyboard not waiting for ACK */ 
int_on(intr_flag) ; /* allow interrupts now */ 

b 


JOO oo ok kk io ok dO a kk cdc ak akc ok ak ak i oe ok ok oko ake ae oe ok oc ake ake ake ak ate ae ok / 
/* kyb_led() - handle changes to LED state */ 


JOO OO I III OGG Ok kok ak ke ak ke okok dak kok kak ake aki te oc ak ak ake ake ok / 


kyb_led() 

*: 

unsigned char state; /* temporary state variable */ 
state = kyb_state >> 4; /* shift into position */ 
state &= 0x07; /* only bits 2:0 are valid */ 
wr_kyb(LED123) ; /* keyboard LED command to buffer */ 
wr_kyb(state) ; /* LED state to buffer */ 

} 


JOO OC oO oR OR do GG kook kok ok ka ak dae ok ak / 


/* kyb_send() - send command to keyboard * [ 
JOC oo Oo Goo Io Gr go kG Gk kiko Gi ck ak ik ak daca / 


kyb_send (resend) 
int resend; /* re-send character if true *«/ 
{ 
if (resend) outp(DATAREG, last_send) ; /* re-send command or data */ 
else if(rb_out(&ko_rb, &last_send) >= 0)/* get char from output buff */ 
outp(DATAREG, last_send) ; /* send command or data */ 
else last_send = 0; /* no character to send */ 
} 
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[OO loki kkoiokok i I IO IO OIG IOI OK a gk ak aka i ak ak ak: a ok ae oie fe ok akc ake ok ake ake ake ake ake ake / 


/* kyb_rest() - restore keyboard interrupts to system * f 
[ROR dG kok kok kok dok dak kok kok kolo ok ok ok ok ak ok kak ok a ak ok ake ak ok ak ke ake ak ak ae ake ake ake ake ote ok ake ake ake ake / 


kyb_rest () 
{ 

iv_rest (0x09) ; /* keyboard interrupt is int 0x09 */ 
} 


JOR RIGO OO ORIG OK IG CR a kk kok aa ae ak ak sk ak dea at akc ake ake / 


/* get_key() - get character from keyboard input buffer * | 
[Ook kc kook ok oko kok kokgkok dak ck okokok kak kok kok ok ak ak skook ak kook a koak a / 


int get_key (pc) /* get char from input buf */ 
unsigned char *pc; /* where to put character */ 
{ 

return(rb_out(&ki_rb, pc)); /* get char from input buff *«/ 
} 


JOO took OGG ooo Gk doko ga dak dodo kk dokok kak ok ak ak ge ok a ok ake de ate ate ake ake ok / 


/* put_key() - put key sequence into keyboard input buffer + / 
[DCO OOOO ICI IOI OO IO OR OIG I dk kok kk ak ak ak te de ak ae / 


int put_key (pc) /* put key seq into input buf */ 
unsigned char *pc; /* where to get sequence */ 
1, 
if (pc(O] == Oxff && pcli] == Oxff) beep(); /* invalid key combo ? */ 
else 
< 
rb_in(&ki_rb, *pctt+); /* write ASCII character */ 
return(rb_in(&ki_rb, *pc)); /* write scan code */ 
} 
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/ oh she sk ok ok ve ok ok ole oe ok ok ok pe oe ok ok oe ok oe oe ok oe ode oe ok oe oie oe oie oe oe oe oe oe ode he ake oie oe oe 3 de oe oe ofc ok oe te he ok sic oe oe ook is ie oe oie oie oe ok ote oe oe de oie le oe / 


/* kyb_int_hand() 


keyboard interrupt handler 


a f 


J kok Rk kk ko ok kek kak ok oie ok ok ok se ok keke oe oko keke oie ok ok ake ok kee oke fe ake ois oe ok ok ake fe akc oks de aka 2k okt ke ake ake ok ok ake ake ake ak ate ake // 


kyb_int_hand() 
nA 


unsigned char key; 

key = inp(DATAREG) ; 
if (key 
else if(key & 0x80) 
{ 


aa as 
Son mc 


switch(key) 
4. 
case ACK: 
kyb_send (0) ; 
break; 


case RESEND: 
kyb_send(1); 


break; 


default: 


switch(released = key & Ox7f) RA 


case CTRL: 
kyb_state 
break; 


case LSHF: 
kyb_state 
break; 


case RSHF: 
kyb_state 
break: 


case ALT: 
kyb_state 
break; 


CAPS: 
NUML : 
SCRL: 
break; 


Case 
case 
Case 
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& 


& 


B_FULL) beep() ; 


tag 


/* caps lock, numlock or scrllock released 


/* tmp to hold keyboard transmission 


/* get keyboard transmission 
/* tell typist, buffer full 
/* key release or keyboard reply ? 


/* keyboard acknowledge 7? 


/* keyboard re-send request ? 


/* must be a key release 


Pa 


save released key for demo 


/* and check modifier keys 


/* control key 
/* clear from 


/* left shift key 
/* clear from 


/* right shift key 
/* clear from 


/* alternate key 


ff 


/* clear from 
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released 7? 
state byte 


released ? 
state byte 


released ? 
state byte 


released 7 
state byte 


? 


/* these are toggle keys, only means it was 


* f 
*/ 


case INS: 
kyb_state &= ~S_INS; 


break; 
default: 
break; 
} 
} 
} 
else switch(depressed = key & Ox7f) 
{ 
case CTRL: /* control 
kyb_state |= S_CTRL; /* get 
break; 
case LSHF: /* left shift 
kyb_state |= S_LSHF; /* set 
break; 
case RSHF: /* right shift 
kyb_state |= S_RSHF; /* set 
- break; 
case ALT: /* alternate 
kyb_state |= S_ALT; /* set 
break: 
case CAPS: /* caps lock 
if(kyb_state & S_CAPS) 
kyb_state &= ~S_CAPS; /* 
else kyb_state |= S_CAPS; /* otherwise, 
kyb_led(); 
break; 
case NUML: /* numlock 
if(kyb_state & S_NUM) 
kyb_state &= ~S_NUM; 
else kyb_state |= S_NUM; /* otherwise, 
kyb_led() ; 
break; 
“eu” case SCRL: /* scrllock 


S_SCRL) 
“S_SCRL; 
|= S_SCRL; 


if(kyb_state & 
kyb_state &= 
else kyb_state 


/* 


/* insert key released ? 
/* clear from state byte 


/* no default 


/* gave depress key for demo 


key pressed 7? * 


in state byte 


key pressed 7? * 


in state byte 


key pressed 7? 
in state byte 


key pressed 7? * 


in state byte 


key pressed ? * 
/* caps on ? * 
turn caps off > 
turn caps on * 
/* adjust Lock LED 


key pressed ? 


/* numlock on 7? * 
/* turn numlock off 
turn numlock on 7? : 
/* adjust NumLock LED * 


key pressed 7? 


scrllock on 7? * 
/* turn scrllock off * 
/* otherwise, turn scrllock on 


7 /* adjust ScrlLock LED 


Keyboard-Interface Controller - Programming Example 


S-{ 


* f 


*/ 


break; 


case INS: /* insert key pressed 7? */ 
kyb_state |= S_INS; /* set in state byte */ 
break: 
default: {* test for combination keys */ 
if (kyb_state & S_ALT) /* alt key pressed 7? */ 
: if (kyb_state & S_CTRL) /* ctrl key pressed ? */ 
: if(key == DEL) sys_reset() ; /* CTRL/ALT/DEL ? */ 
else beep() ; /* NOTE: No ALT/CTRL table in demo. */ 
if(kyb_state & (S_LSHF | S_RSHF)) /* shift key pressed ? */ 
; beep() ; /* NOTE: No ALT/SHIFT table in demo */ 
ee put_key(&keyboard[key] [T_ALT]) ; /* use alt table */ 
oes if (kyb_state & S_CTRL) /* ctrl key pressed ? */ 
; if(kyb_state & (S_LSHF | S_RSHF)) /* shift key pressed ? */ 
; beep() ; /* NOTE: No CTRL/SHIFT table in demo */ 
| ta: put_key (&keyboard[key][,T_CTRL]); /* use ctrl table */ 
a if(kyb_state & (S_LSHF | S_RSHF)) /* shift key pressed ? */ 
: if (keyboard[key][T_A_N] & S_CAPS) /* alpha character ? */ 


if (kyb_state & S_CAPS) /* caps lock in effect ? 
put_key (&keyboard[key] [T_NORM]) ; /* use normal table ? 
else put_key (&keyboard[key] [T_SHFT]) ; /* use shift table 


Bano 


ote ; 7 


} 
else if(keyboard[key][T_A_N] & S_NUM) /* numeric character ? * 
1 
if (kyb_state & S_NUM) /* numlock in effect ? */ 
put_key(&keyboard[key] [T_NORM]) ; /* use normal table */ 
else put_key(&keyboard[key] [T_SHFT]) ; /* use shift table */ 
} 
else put_key(&keyboard[key] [T_SHFT]) ; /* use shift table */ 
Vi 
else put_key(&keyboard[key] [T_NORM]) ; /* use normal table */ 
break; 
} 
eoi(0); /* end of interrupt to PIC */ 


} 
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JRO OGIO lo OOO ik odok ok ok ok a i kak ke ak ok sk ok ak ak a ak oak cake ok ok ak ak ake kok a oie oka ake ake ake ake ake ake ak ae ake // 


/* kyb_exm() - keyboard example program fp 


{ROCIO IC IOI IOI ICI IO ICICI AOI dO ke ak ak IO I I IOI I i a ar ok Ik ake ake ke aie ok ok ak ake ake aks ak oc aca / 


kyb_exm() 
{ 
static MESSAGE mmain[] = /* opening menu */ 
1; 

{ 3, 24, "Keyboard Example" }, 

{ 5, 24, "Fi. Toggle DIGITAL extended mode on or off" }, 

{ 6, 24, "F2. Set key click volume" }, 

{ 7, 24, "F3. Toggle autorepeat on or off" }, 

{ 8, 24, "F4. Set autorepeat delay and rate" }, 

{ 9, 24, "F5. Show keyboard version and mode" }, 

{ 10, 24, "F6. Restore keyboard to defaults" }, 

{ 11, 24, "F7. Show last depressed and last released keys" }, 

{ 12, 24, "F1i0. Return to Main menu" }, 

1 0, GO; OF, 
FF: 
char line[512]; /* to hold input line */ 
int ext mode = QO; /* to hold extended mode toggle state */ 
int auto_rep = 0; /* to hold auto-repeat toggle state */ 
int d; /* to hold input */ 
art x4 /* to hold input */ 
int y; /* to hold input */ 
unsigned int intr_flag; /* to hold CPU IF state */ 
#define ROW 14 /* where to put input lines */ 


#define COL 17 


wr_kyb(AREPON) ; /* ensure autorepeat is on */ 
wxr_kyb(EXT_EXM) ; /* exit extended mode */ 
wr_kyb(LED4_ON) ; /* led #4 on */ 
line[0O] = QO; /* null line */ 
while(1) /* forever until F10 */ 
{ 
disp_menu(mmain) ; /* display menu for keyboard example */ 
switch(line[0]) /* which function key ? */ 
{ 
case F1: /* toggle extended mode */ 
if (ext_mode) /* in extended mode ? */ 
{ 
wr_kyb(EXT_EXM) ; /* exit extended mode */ 
wr_kyb(LED4_ON) ; /* led #4 on */ 
ext_mode = 0; /* clear toggle */ 
z 
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else /* not in extended mode 
4, 
wr_kyb(ENT_EXM™) ; /* enter extended mode 
wr_kyb(LED4_0OF) ; /* led #4 off 
ext_mode = 1; /* set toggle 
} 
break; 
case F2: /* change keyclick volume 


disp_str(ROW, COL, 
"The key click volume has a range of 0 to 6 in 4 increments") ; 
disp_str(ROW + 1, COL, 
"0 = Off 2 = Low 4 = Medium 6 = High"); 
disp_str(ROW + 7, COL, 
"Enter key click volume (0 - 6):"); 


oe ‘4 
de / 


+ f 


He / 


* f 


get_keys(ROW + 7, COL + 36, line); /* get chioce */ 
sscanf(line, "4d", ky); /* ascii to int */ 
iffy <O || y>6) y=4; /* keep it in bounds */ 
wr_kyb(SETVOL) ; /* write set volume command */ 
wr_kyb(y) ; /* write volume data */ 
break; 
case F3: /* toggle auto-repeat ? */ 
if (auto_rep) /* auto-repeat off ? */ 
+ 
wr_kyb(AREPON) ; jx autorepeat on * ff 
auto_rep = 0; /* clear toggle */ 
} 
else /* auto-repeat is on */ 
{ 
wr_kyb(AREPOFF) ; /* autorepeat off */ 
auto_rep = 1; /* aet toggle ff 
} 
break; 
case F4: /* set auto-repeat rate ? */ 


disp_str(ROW, COL, 


"The autorepeat rate has a range of 2 to 30 in 32 increments"); 


disp_str(ROW + 1, COL, 

"The autorepeat rate is calculated as follows:"); 
disp_str(ROW + 2, COL, 

"Rate = 1 / (.00417 * (2°Y) * (X + 8)"); 
disp_str(ROW + 3, COL, 
"The delay, before autorepeat begins, has a range of"): 
disp_str(ROW + 4, COL, 

"25 seconds to 1 second in .25 second increments") ; 
disp_str(ROW + 5, COL, 
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"The delay, before autorepeat begins, is calculated as follows:"); 
disp_str(ROW + 6, COL, "delay = (D + 1) * .25"); 
disp_str(ROW + 7, COL, 
"Enter repeat rate Y value (O - 3):"); 
disp_str(ROW + 8, COL, 
"Enter repeat rate X value (0 - 7):"); 
disp_str(ROW + 9, COL, 
"Enter delay value D (0 - 3):"); 


get_keys(ROW + 7, COL + 36, line); /* get input */ 
sscanf(line, "4d", &y); /* ascii to int */ 
iffy < oO || y > 3) y = 2; /* keep in bounds */ 
get_keys(ROW + 8, COL + 36, line); /* get input */ 
sscanf(line, "%d", &x); /* ascii to int */ 
if(x <0 |] x > 3) x = 2; /* keep in bounds */ 
get_keys(ROW + 9, COL + 30, line); /* get input */ 
sscanf(line, "4d", &d); /* ascii to int */ 
iffd <0 || d > 3} d= 2: /* keep in bounds */ 
y <<= 3; /* shift into correct position */ 
d <<= 5; /* shift into correct position */ 
wr_kyb(SETAR) ; /* write set auto-repeat rate command */ 
wr_kyb(d | y | x); /* write auto-repeat data */ 
break; 

case F§: /* read keyboard ID and state */ 
intr_flag = int_off(); /* CPU interrupts off */ 
pass_thru(TRUE); /* interface controller in pass-through mode */ 
wr_ked(KYBID) ; /* write keyboard ID command */ 
while(!(inp(COMMAND) & Ox01)) /* wait until data available */ 
y = inp(DATAREG) ; /* read version byte */ 
while(!(inp(COMMAND) & 0x01)) /* wait until data available */ 
x = inp(DATAREG) ; /* read mode byte */ 
pass_thru(FALSE) ; /* interface controller interprets */ 
int_on(intr_flag) ; /* CPU interrupts on */ 
if(x == 2) /* DIGITAL extended mode ? */ 


sprintf (line, 
"Keyboard version #%4d is in DIGITAL extended mode %d", y, x); 
else /* industry~standard mode */ 

sprintf (line, 
"Keyboard version #/4d is in industry-standard mode %d", y, x); 


disp_str(ROW, COL, line); /* display data */ 
break; 

case F6: /* reset keyboard to default values ? */ 
wr_kyb(RESDEF) ; /* write reset to default command */ 
break; 
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case F7: /* show last pressed and last released keys ? */ 

, Line{O] = 0; /* null line */ 
. disp_str(ROW, O, "Press F7 again to cancel") ; 

while(line[O] != 0 || line[1] != F7) /* F7 terminates */ 


{ 
sprintf(line, "Last depressed: %02x", depressed) ; 
disp_str(ROW + 3, 0, line); 
sprintf(line, "Last released: %02x", released) ; 
disp_str(ROW + 3, 40, line); 
chk_dt() ; /* display date and time ? */ 
if (get_key(&line[0])) /* scan code */ 
while(!get_key(&line[1])) /* character code */ 


b 


} 


break; 


case F10: 
return; 
} 
line[O] = get_fkey(); /* get menu selection */ 
} 
anil } 
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Chapter 9 
Serial Communications 


Overview 


The 8250A universal asynchronous receiver/transmitters (UART) in the 
VAXmate workstation provide asynchronous communications for the communi- 
cations port, the printer port, and the modem port. 


The 8250A UART converts parallel data from the internal buses to serial data 
for transmission to external devices. The 8250A UART receives serial data and 
converts it to parallel data for the internal buses. The serial data has the 
format of a start bit; five to eight data bits; an optional parity bit; and 1, 1-1/2, 
or 2 stop bits. 


The 8250A UART also has a programmable baud rate generator. 


Additional Sources of Information 


The following documents provide additional information on programming the 
d 


8250A UART serial communications devices 


* Series 8000 Microprocessor Family Handbook (National Semiconductor 
Corporation) 


¢ 1984 Data Communications Products Handbook (Western Digital 
Corporation) 


oc 
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8250A UART Registers 


Table 9-1 lists the 8250A UART registers and their registers at each port. 


oar 9-1 8250A UART Register Addresses 


inornnanicanet 


Receive buffer (Read)/Transmit 


holding register (Write) or 
Divisor latch (LSB) * 


Interrupt enable 
or Divisor latch (MSB) * 


Interrupt identification 
Line control 

Modem control 

Line status 


Modem status 
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Bit 7 of the line control register controls access to the divisor latches. 
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Coml 


03 F8H 


O3F9H 


O3FAH 
O3FBH 
O3FCH 
O03FDH 
O3FEH 


sinstnrincsrnemantonnsntsrenenete TANNA ERR 
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Modem 


(Com2) 
02 F8H 


Q02F9H 


02FAH 
02FBH 
02FCH 
02FDH 
02FEH 


Printer 


OCAOH 


OCALH 


0CA2H 
0CA3H 
OCA4H 
OCA5H 
OCA6H 


The line control register is described later in this chapter. 
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Receive Buffer Register/Transmitter Holding Register 
(0O3F8H/02F8H/0CA0H) 


7 6 2 4 3 2 1 0 
ana >] —— {= ——————| 
DATA BITS 
SRE Lee SNe cee Ae aS LOM See ae Crm E ST (Aenea Seoeere 


Bit R/W_ Description 
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7-0 R Reading this register accesses the receive buffer. 
WwW Writing this register accesses the transmitter holding register. 
Bit 0 (the least significant bit) is the first bit transmitted or 
received. 
When the line control register is programmed for word lengths of 
less than 8 bits, the unused bits are read as zeros. 


When bit 7 of the line control register is set to 1, reading or writ- 
ing this register accesses the least significant byte of the divisor 
latch. 
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Interrupt Enable Register (03F9H/02F9H/O0CA1H) 
7 6 5 4 3 2 1 0 


M |RECEIVE|THRE 
STATUS |LINE | INTRPT 
| STATUS 

| INTRPT 
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Bit R/W_ Description 
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7-4 R/W Always 0 


3 R/W MODEM STATUS INTRPT - Modem Status Interrupt 
0 = Modem status interrupt disabled 
1 = Modem status interrupt enabled 


2 R/W RECEIVE LINE STATUS INTRPT - Receive Line Status 
Interrupt 
Q = Receive line status interrupt disabled 
1 = Receive line status faleeniat enabled 


1 R/W THRE INTRPT - Transmit Holding Register Empty Interrupt 
0 = Transmit holding register empty interrupt disabled 
ie = Transmit holding register empty interrupt enabled 


RECEIVE DATA AVAIL INTRPT - Receive Data Available 
Interrupt 

0= - Receive data available interrupt disabled 

1 Receive data available bas t enabled 
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0) R/W 


Writing all Os to this register disables the 8250A UART interrupt structure. If 
any of bits 3-0 are set, the 8250A UART interrupt str ee ure is enabled. Only 
the functions with set bits can cause an interrupt. 


Because the 8250A UART has only one interrupt output line, you must read 
the interrupt identification register to determine which function or functions 
caused the interrupt. Later in this chapter, the interrupt identification register 
description defines the interrupt conditions for each function. 


NOTE 

Each 8250A UART has a buffer between the interrupt output 
line and the peripheral interrupt controller input. This buffer is 
controlled by bit 3 of the modem control register. Writing a 1 to 
bit 3 of the modem control register enables the buffer and there- 
fore, the 8250A UART interrupt output line. The modem control 
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register is described later in this chapter. 


To use the 8250A UART in an interrupt-driven environment you 
must program the peripheral interrupt controller. For more in- 
formation on the peripheral interrupt controller, see Chapter 3. 
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Interrupt Identification Register (QO3FAH/O2FAH/0CA2H) 
7 6 2 4 3 2 1 0 


naam anenouieinveshnsesncomucanniin 


INTERRUPT __ 
IDENTIFICATION 


Bit R/W_ Description 


7-3 OR Always 0 

2-1 R INTERRUPT IDENTIFICATION 
These two bits identify the highest priority interrupt pending. 
Table 9-2 defines the meaning of the interrupt identification bits. 


0 R INTRPT PENDING - Interrupt Pending 
Q = One or more interrupts pending 
1 = No interrupts pending 
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Table 9-2 Interrupt Identification 


Priority Interrupt Interrupt Interrupt Interrupt 
Level ID Bits Enable Condition Reset 
21 Register 
Bit 
Highest 11 Receiver line Overrun, parity Reading the line 
status error, framing status register 
error, or break 
interrupt 
Second 10 Receive data Assembling a Reading the re- 
available complete word _ ceive buffer 
in the receive register 
buffer 
Third 01 Transmit hold- Transmit hold- Writing the 
ing register ing register transmit holding 
empty empty register 
Fourth 00 Modem status Change in state Reading the 


of CTS, DSR, modem status 
RI, or RLSD register 
signals 
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Line Control Register (083FBH/02FBH/0CA3H) 


Ps 6 S 4 3 2 1 0 
" ices: ——_S 


WORD LENGTH 
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Bit R/W_ Description 

| R/W DLAB - Divisor latch access bit 
0 = Access to the divisor latch is disabled 
1 = Access to the divisor latch is enabled 


When access to the divisor latch is enabled, the least significant 
byte of the divisor latch is read or written through the receive 
buffer/transmit holding register, and the most significant byte of 
the divisor latch is read or written through the interrupt enable 
register, 


The divisor latch is described later in this chapter. 
6 R/W BREAK CONTROL 
0 = Break disabled 
1 = A space (logic 0) state forced on the serial output 
5 R/W STICK PARITY 
0 = Stick parity disabled 
1 = If parity is enabled (bit 3 equals 1), stick parity is enabled 
When stick parity is enabled, the parity bit is transmitted and 
received in the following manner: 
* If bit 4 equals 1, the parity bit is always transmitted and 
received as a 0. 
e If bit 4 equals 0, the parity bit is always transmitted and 
received as a 1. 
R/W PARITY SELECT 
0 = Even parity (except for stick parity as described in bit 5) 
1 = OQdd parity (except for stick parity as described in bit 5) 


— 
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Bit R/W_ Description (Line Control Register - cont.) 
3 R/W PARITY ENABLE 

Q = Parity disabled 

1 = Parity enabled 
2 R/W STOP BITS 

0 = 1 stop bit 

1 = 1-1/2 stop bits (5-bit word length) 

2 stop bits (6, 7, or 8-bit word length) 
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This bit sets the number of stop bits only for transmitted 
characters. The receiver uses only the first stop bit detected. 


1-0 R/W WORD LENGTH 
00 = 5 data bits 
O01 = 6 data bits 
10 = 7 data bits 
11 = ‘8 data bits 


When reading the receive buffer, unused bits are read as 0. 
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Modem Control Register (O3FCH/02FCH/0CA4H) 
7 6 5 4 3 2 | 0 


Bit R/W_ Description 
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7-5 R/W Always 0 


4 R/W LOOP 
) = Diagnostic loopback disabled 


ni 


3 R/iW OUT2 
) = The buffer between the 8250A UART interrupt output and 
the peripheral interrupt controller input is disabled. 
1 = The buffer between the 8250A UART interrupt output and 
the peripheral interrupt controller input is enabled. 


Each 8250A UART has a buffer between the interrupt output line 
and the peripheral interrupt controller input. This buffer is con- 
trolled by bit 3. Enabling the buffer enables the 8250A UART in- 
terrupt output line. 


To use the 8250A UART in an interrupt-driven environment you 
must program the peripheral interrupt controller. For more infor- 
mation on the peripheral interrupt controller, see Chapter 3. 


R/W OUT1 (not connected to anything) 


i R/W_ RTS - Request to send 
0 = RTS is a logic 0 at the external connector 
1 = RTS is a logic 1 at the external connector 


0 R/W DTR - Data terminal ready 
0 = DTR is a logic 0 at the external connector 
1 = DTRis a logic 1 at the external connector 


ase gees peat annotate 


BO 
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NOTE 
See the section "Modem Control Programming Exceptions” in 
this chapter. 
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Diagnostic Loopback 
When the diagnostic loopback is enabled, the following conditions exist: 


e The serial output at the external connector is set to a space (logic 0) 
state. 


e The serial input is internally disconnected. 


* The output of the transmit shift register is internally connected to the 
input of the receive shift register. 


e The four modem inputs (DSR, CTS, RI. and RLSD) are internally 
disconnected. The four modem outputs (DTR, RTS, OUT1, and OUT2) 
are connected to the four modem inputs as follows: 


- The DTR output is connected to DSR input 

- The RTS output is connected to the CTS input 

- The OUT1 output is connected to the RI input 

- The OUT2 output is connected to the RLSD input 


When the diagnostic loopback is enabled, the receive and transmit interrupts 
continue to function normally. The modem control and the line status inter- 
rupts are also functional, but the source of the interrupt is changed as follows: 


e The line status interrupt is activated by writing an appropriate value to 
one of the line status register bits 5-0. A set bit creates the interrupt 
condition. 

e The modem status interrupt is activated by writing an appropriate value 
to one of the modem status register bits 3-0. A set bit creates the inter- 
rupt condition. 
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Line Status Register (083FDH/02FDH/0CA5H) 
fj 6 5 4 3 Z 1 0 


Bit R/W_ Description 
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7 R Always 0 
6 R XMIT SHIFT REG EMPTY - Transmit Shift Register Empty 

0 = Transmit shift register contains data being transmitted 

1 = Transmit shift register is empty 

This bit is cleared by writing data to the transmit holding register. 

5 R XMIT HOLDING REG EMPTY - Transmit Holding Register 
oy 

Q = Transmit holding register is full. 

1 = The 8250A UART is ready to accept a character for 
transmission. If the transmit holding register interrupt 
enable bit (interrupt enable register) is set, this condition 
creates an interrupt. 

This bit is cleared by writing data to the transmit holding register. 

4 R/W BREAK INTRPT - Break Interrupt 

(. = Break interrupt is not active 

1 = The serial input line at the connector has been held in a 
mark (logic 1) state for longer than a full character 
transmission, including start and stop bits. 


This bit is cleared by reading this register or writing the bit. 


3 R/W FRAMING ERROR 
0 = No framing error 
1 = The received character did not have a stop bit. 


This bit is cleared by reading this register or writing the bit. 
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Bit R/W_ Description (Line Status Register - cont.) 


2 R/W PARITY ERROR 
Q = No parity error 
1 = Received character did not have the correct parity. 


ih 


This bit is cleared by reading this register or writing the bit. 


1 R/W OVERRUN ERROR 
Q = No overrun error 
1 = The CPU did not read the data in the Receive Buffer regis- 
ter before the next character was received. Thus, the unread 
character was destroyed. 


This bit is cleared by reading this register or writing the bit. 


0 R/iW RECEIVE DATA READY 
0 = Receive data buffer is empty. 
1 = A complete character has been received and assembled into 
the receive Buffer register. 


This bit is cleared by reading this register or writing the bit. 
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When any of bits 4-1 are set, a receiver line status interrupt is generated. 
When bit 0 is set, a receive data available interrupt is generated. 


9- 12 Serial Communications - Hardware Description 


Modem Status Register (QOFEH/O2FEH/0CA6H) 
7 


6 R 


aw 
oe 
ote 
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6 5 4 3 Z 1 


T sys L 
DELTA 


RLSD RI 


Description 
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RLSD - Received line signal detect 
Q = RLSD at external connector is a logic 0 
1 = RLSD at external connector is a logic 1 


RI - Ring indicator 
Q = RI at the external connector is a logic 0 
1 = RI at the external connector is a logic 1 


DSR - Data set ready 
QO = DSR at the external connector is a logic 0 
1 = DSR at the external connector is a logic 1 


CTS - Clear to send 
Q = CTS at the external connector is a logic 0 
1 = CTS at the external connector is a logic 1 


DELTA RLSD - Delta Receive Line Signal Detect 

0 = RLSD has not changed state. 

1 = Since the last time this register was read, the RLSD bit has 
cha gs state. 


TRAIL. EDGE OF RI - Trailing Edge Of Ring Indicator 

Q = The ring indicator has not changed state. 

1 = Since the last time this register was read, the ring indicator 
at the external connector changed from a logic 0 to a logic 1. 


Reading this register clears the bit. 
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Bit R/W_ Description (Modem Status Register - cont.) 


0 = DSR has not changed state. Reading the register clears the 
bit. 

1 = Since the last time this register was read, the DSR signal 
has changed state. 


Reading this register clears the bit. 


0 R Delta CTS - Delta Clear to Send 
0 = CTS has not changed state. 
1 = Since the last time this register was read, the CTS signal 
has changed state. 


Reading this register clears the bit. 
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rupt is generated. 


# 


Bits 7-4 are the complement of the signal levels at the chip input pins. 
However, the RS-232 receiver buffer inverts these signals, so the bits reflect 
the true state of the lines at the external connector. 
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Divisor Latches 
7 6 5 4 3 2 1 0 
Aon ve sen TTT AER te SE er en ee eee EE ne eee 


DIVISOR LATCH 
LEAST SIGNIFICANT BYTE 
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DIVISOR LATCH 
MOST SIGNIFICANT BYTE 
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When bit 7 of the line control register (Divisor latch access bit) is equal to 1, 
the least significant byte of the divisor latch is read or written through the 
receive buffer/transmit holding register, and the most significant byte of the 


divisor latch is read or written through the interrupt enable register. 


These two, 8-bit latches store a 16-bit divisor in the range 1 to 65,535. The 
output frequency of the baud rate generator is 1.8432 Mhz divided by the 16- 
bit divisor. These divisors must be loaded during initialization. The desired 
output frequency is 16 times the desired baud rate. Table 9-3 lists the divisor 
used for the standard baud rates. Table 9-3 was calculated using the following 
formula: 


divisor = (1843200 / 16) / desired_baud_ rate 
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Table 9-3. Baud Rate Table 
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Baud Rate Divisor Percentage of Error Between Desired 
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110 1047 — 0,026 
134.5 857 +0.058 


2000 08 +0.69 


7200 16 2 
9600 12 

19200 6 

38400 C 
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Modem Control Programming Exceptions 


Speed Select and Speed Indicator control signals are not controlled by the 
8250A UART. Instead, these signals are controlled by writing to a special pur- 
pose register. 


The special purpose register is located at I/O address OC80H. 


NOTE 

When changing the Speed Select or Split Baud Rate, maintain 
the integrity of the other bits in this register. Split baud rates 
are achieved by switching the output (RCLK H) between two 
sources, BD OUT CLK (baud out of the 8250A UART) and a 
1200 baud counter. 
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Special Purpose Register (OC80H) 
7 6 5 4 3 2 1 9) 


inner 


Bit R/W_ Description 

7 R Write protect 

0 = Selected diskette drive is not write protected 
1 = Selected diskette drive is write protected 


6 R Track 0 
Q = Head of selected diskette drive is not at track 0 
1 = Head of selected diskette drive is at track 0 
5 R Index 
O = Index hole not in position for selected diskette drive 
1 = _ Index hole in position for selected diskette drive 


4 R Speed Indicator 
Q = Modem control speed select asserted 
1 = Modem control speed select not asserted 
R/W_ Disable Video 
0 = Video controller disabled 
1 = Video controller enabled 
2 R/W_ Split Baud Rates 
QO = (Receive = Transmit = programmed) 
1 = (Receive = 1200) (Transmit = programmed) 


Aah 


1 R/W_ Disable Communications 
Q = Integral communications ports connected to I/O address 
space 
1 = Integral communications ports disconnected from I/O address 
space 
0 R/W_ Speed Select 
Q = Speed select asserted 
1 = Speed select not asserted 
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Communications Connector Signals 


The communications connector, a 25-pin, male, D-subminiature, is located on 
the rear bezel of the VAXmate workstation. This connector is functionally 
compatible with RS-232-C and electrically compatible with RS-423, configured 
as DTE (Data Terminal Equipment). Table 9-4 lists the signals supported by 
this connector, 


Table 9-4 Communications Connector Signals 
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Pin Signal Name 

1 Protective ground 
Z Transmitted Data 
3 Received Data 

4 Request to Send 
5 Clear to Send 
6 

7 

8 

9 


Data Set Ready 
Signal ground 
Receive Line Signal Detect 


11 Not used 
LZ Speed Indicator 


Ze Ring Indicator 


2¢ Speed Select 
24 me 
25 — 
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» ; * 
Printer Connector Signals 
The printer connector is a 6-pin MMJ, female, modified modular connector 
located on the rear bezel of the VAXmate workstation. Table 9-5 lists the sig- 
nals this connector supports. 


Table 9-5 


Printer Connector Signals 


Signal Name 
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1 Data Terminal Ready 

2 Transmit Data 

3 Transmit Common (Signal ground) 
4 Receive Common (Signal ground) 
4) Receive Data 

6 Data Set Ready 


Pee 
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Modem Connector Signals 


The modem connectors are modular TELCO (telephone line) compatible connec- 
tors located on the optional modem board, protruding through the rear panel of 
the VAXmate workstation. bi connectors use an 8-pin, keyed modular housing 


for an RC1L1C jack (or CA11 jack in Canada). Table 9-6 lists the signals for a 
modem connector. Table a lists the signals for a handset connector. 


Table 9-6 Modem PoE PONS Line Connector Signals 


Pin No. Signal Nene ‘Meaning 

1 N.C. No connection 

2 N.C, No connection 

3 MIC Not used 

4 Tip TELCO signal source 
) RING TELCO signal return 
6 MI Not used 

7 N.C. No connection 

8 N.C, No connection 


Table 9-7 Handset Connector Signals 
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Pin No. 
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Signal Name 
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Meaning 
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2 N.C. No connection 

3 MIC Not used 

4 RING TELCO signal return 
5 TIP TELCO signal source 
6 MI Not used 

7 NAC. No connection 

8 N.C. No connection 
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No connection 


Programming Example 


The examples in this chapter demonstrate: 


° Initializing an 8250A UARTA serial communications device 
° Handling interrupt-driven serial I/O 

° Handling hardware and software handshaking protocols 
CAUTION 


Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


The example provides routines as described in the following: list: 


device_init 
device_open 
ser out 
restart 
device int 
device_close 


puts_buf 


get buf 
so 


int_coml 


int_prnt 


Establishes a known state for a serial port 
Activates the serial port and interrupts 
Handles character transmissions 

Activates interrupt-driven serial transmissions 
Soordinates all of the device interrupts 
Deactivates the serial port and interrupts 


Puts a string of characters into a ring buffer from the 
application 


Gets a character from a ring buffer for the application 
The serial example 


An interrupt vector entry point for the com1 serial port 
interrupt handler 


An interrupt vector entry point for the modem serial port 


interrupt handler 


An interrupt vector entry point for the serial printer port 
interrupt handler 


Serial Communications - Programming Example 


Program Description 
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Constant Value 


ns 


P ENAB through WORDS 
RDRDY through BREAK 
ENA MOD through 
ENA_THE 

DTR through LOOP 
RLSD through CTS 


HHS through DEV_OFF 


CLK RATE 


NO_PAR through S_ BIT2 


cS ae wtnrnsimsin SOND 


Description 
Define the line control register bit values. 
Define the line status register bit values. 


Define the interrupt enable register bit values, 


Define the modem control register bit values. 
Define the modem status register bit values. 


Define the bit values used to maintain the driver 
status, The driver status is part of the structure 
type DEV DAT. 

Is divided by the desired baud rate to give the 
value for the baud rate divisor registers. 


Clarify the logic of the function, device_ init. 
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#include "kyb.h" 


#include "rb.h" 


#include "example.h" 
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/* define 
J te ke ok ok 


/« define 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


P_ENAB 
_EVEN 
P_ODD 
P_STIK 
WORDS 
WORD7 
WORD6 
WORDS 


“3 


/« define line 


#define 
#define 
#define 
#define 


RDRDY 
THRE 
ERRORS 
BREAK 


0x08 
0x10 
0x00 
0x20 
0x03 
0x02 
0x01 
0x00 


constant values used in example serial driver 
JO ok ok a koko kok koko ak ok ok ok oko ak ok ok akc ok ae a ook ok ak keke fo ok ok ak ak fe fe oe ok fe ake ake ake ak abe ake // 


line control register bit values */ 


/* parity enabled 
/* EVEN parity select 
/* ODD parity select 
/* enable stick parity 
/* 8-bit word size 
/* 7T-bit word size 
/* 6-bit word size 
/* 85-bit word size 


status register bit values */ 


0x01 
0x20 
0x0e 
0x10 


/* received data ready 

/* transmit holding reg empty 
/* overrun, parity, framing 
/* received break 


/* define interrupt enable register bit values */ 


#define ENA_MOD 0x08 
#define ENA_REC 0x05 
#define ENA _THE 0x02 
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/* enable modem status 
/* recv line stat & rd rdy 
/* enable trans hold empty 
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* / 
“/ 
«/ 
»/ 
* f 
* f 
« / 
*/ 


* / 
*/ 
* ff 
 f 


* f 
/ 
*/ 


/* define modem control register bit values */ 


#define DTR Ox01 /* data terminal ready */ 
#define RTS 0x02 /* request to send */ 
#define OUT2 0x08 /* out 2 interrupt ctrl */ 
#define LOOP 0x10 /* loopback mode */ 


/* define modem status register bit values */ 


#define RLSD 0x80 /* recv line signal detect */ 
#define RI 0x40 /* ring indicator * 
#define DSR 0x20 /* data set ready * f 
#define CTS 0x10 /* clear to send */ 


/* define driver status bit values «/ 


#define HHS 0x80 /* use hardware handshake */ 
#define F_XOFF 0x40 /* x-off pending flag */ 
#define F_XON 0x20 /* x-on pending flag */ 
#define DEV_CLS 0x10 /* device close request */ 
#define SWAIT 0x04 /* sending stopped */ 
#define DEV_OFF Ox01 /* driver off line */ 


/* define some general constants */ 


#define CLK_RATE 115200L /* 1843200 / 16 = 115200 */ 
#define X_OFF 0x13 /* x-off (DC3) character */ 
#define X_ON Ox11 /* x-on (DCi) character */ 


/* program constants used to initialize the line control register */ 


#define NO_PAR 0 /* no parity */ 
#define EV_PAR 1 /* even parity + f 
#define OD _PAR 2 /* odd parity x f 
#define SC_PAR 3 /* stick parity clear */ 
#define SS_PAR 4 /* stick parity set */ 
#define S_BIT2 0x04 /* 2 stop bits */ 
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The structure type SERIAL declares the relationship of the 8250A UART reg- 
isters in I/O space. The registers accessed by the members rtbl and iebh 
depends on the following: 


° If bit 7 of the line control register is set, rtbl accesses the low byte 
of the baud rate divisor and iebh accesses the high byte of the baud 
rate divisor. 


° If bit 7 of the line control register is clear, rtbl accesses the receive 


register when reading and the transmit register when writing, and 


iebh accesses interrupt enable register. 


The structure type DEV DAT stores the characteristics of the individual de- 
vices, the current status, and the pointers to the buffers. 


GOO IO IGG GIO ICICI OR IO IORI I I A IOI II CC ICICI IC fe ak ae ake ake ake ake // 


/* define structures used in example serial driver 
[FORO OR I Ok kook ok kok dak kof akc oki akc ok ok kok ak ake ok ake oie oie ofc kc ok kak of ok oe ok oe ofc ae ake ake af ae ake akc ofc ake ke ke abe akc akc fe ke ake ake ake ake ak otk / 


typedef struct 


{ 


{ 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
SERIAL; 


SERIAL 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
RING_ BUFF 
RING_ BUFF 
unsigned 
DEV_DAT; 


char 
char 
char 
char 
char 
char 
char 


typedef struct 


int 
int 
int 
int 
int 
int 
int 


char 


void int_on(); 
int int_of 
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£0); 


rtbl; 
iebh:; 
int ident ; 
line_ctrl; 


modem_ctrl; 


line_stat: 


modem_stat; 


dev_dat 


*base; 
pic; 
ir_bit; 
baud; 
word _siz; 
parity; 
stop_bits; 
req.d3sr; 
*prbi ; 
*prbo; 
stat _drv; 


/* receive/transmit/baud low 
/* int enable reg/baud high 
/* int identification reg 

/* line control register 

/* modem control register 

/* line status register 

/* modem status register 


/* base i/o address of device 
/* PIC number it belongs to 
/* IR bit in PIC 

/* desired baud rate 

/* desired word size 

/* even, odd, none, stick 
f/* 1, 1 - 1/2, 2 

/* DSR required flag 

/* ptr to input ring buff 
/* ptr to output ring buff 
/* state of driver 
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*/ 


*/ 
*/ 
*/ 
x / 
* ff 


*/ 
*/ 
*/ 
*/ 
* f 
« / 
* f 
* f 
* f 
* f 
 / 


The function device init establishes a known state for the 8250A UARTA 
serial device. Two items of interest are stick parity and stop bits. If stick 
parity is selected, the parity bit is set to the opposite state of the even/odd 
parity bit. If more than one stop bit is selected, the number of stop bits 


depends on the word size. If the word size is five data bits, there are 1 1/2 stop 
bits. All other word sizes generate 2 stop bits. These characteristics are a func- 


tion of the device, not the code. 


/ Rk doko ok dk iolok kkk Gk dak dokokok ak akkok / 


/* device_init() - establish a known state for a serial port 


*/ 


[ORR RRO kok kok kok ok dee ok ok ok ok ok sk ok feof ok keke akc ok oko ak ok kc ake akc ake oe ake ok akc oe ake afc ake ake ok oe ae ak oe ae ak / 


void device_init (pdd) /* initialize serial port */ 
register DEV_DAT *pdd; /* pointer to device data */ 
{ 
unsigned int tbaud; /* temp to hold results */ 
unsigned char tpar; /* temp to collect results */ 
register SERIAL «ps; /* pointer to SERIAL struct */ 
tbaud = CLK_RATE / pdd->baud; /* calculate baud rate divisor */ 
switch(pdd->parity) 
{ 
case NO_PAR: /* no parity */ 
tpar = NO_PAR; 
break; 
case EV_PAR: /* even parity */ 
tpar = P_ENAB | P_EVEN; 
break; 
case OD_PAR: /* odd parity */ 
tpar = P_ENAB | P_ODD; 
break; 
case SC_PAR: /* stick, parity bit clear */ 
tpar = P_ENAB | P_STIK | P_EVEN: 
break; 
case SS_PAR: /* stick, parity bit set */ 
tpar = P_ENAB | P_STIK | P_ODD; 
break; 
, 
switch (pdd->word_siz) /* desired word size 7? */ 
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case 8: 
tpar |= WORD8; /* 8 data bits ? */ 
break; 
case 7: 
tpar |= WORD7; /* 7 data bits 7? */ 
break; 
case 6: 
tpar |= WORD6: /* 6 data bits */ 
break; 
case 5: 
tpar |= WORDS; /* 5 data bits ? */ 
break; 
} 
if (pdd->stop_bits) tpar |= S_BIT2; /* set stop bits */ 
ps = pdd->base; /* get shorter pointer */ 
outp(&ps->iebh, 0); /* interrupts off */ 
outp(&ps->modem_ctrl, LOOP) ; /* put in loopback mode */ 
outp(&ps->line_ctrl, 0x80) ; /* access baud rate divisor */ 
outp(&ps->rtbl, tbaud) ; /* baud rate divisor lo byte */ 
outp(&ps->iebh, tbaud >> 8); /* baud rate divisor hi byte */ 
outp(&ps->line_ ctrl, tpar); /* bits per char, parity */ 
pdd->stat_drv |= DEV_OFF; /* transmit int off */ 
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The function device open prepares the driver to handle interrupts and the 
device to receive characters. Because the modem interrupt has the lowest prior- 
ity, it is enabled only for hardware handshaking. In that instance, it notifies 
the driver to restart character transmissions. 


Setting the modem control register bit OUT2 connects the 8250A UARTA in- 
terrupt output to the 8259A interrupt input. This bit must be set to operate a 
serial device in an interrupt-driven environment. 


rf j pe Me ok ot ok She ole ote she oie Re oe oe eke ote he he she ok te the oe she he ake fe he he he oe he oe ke fe ake he oe tie oe see oe oe eo oe oie oe oie ote hs Oe OH he oie ie ole He he okt oc it oe oie oie toe eo / 
j f 


/* device_open() - activate serial port and interrupts +f 


/ : she she oe oh tke oie oko whe che the he oe ie Wt eo ois ole ode ake oie ote oh the he ote oh oe ote He he oe eo he oh oie ie ok oe oh oe ke he oe ke oe oie ok oe ok fe oe he oe ol oe ead oe oe che ot oe ie oe oe oe ok / 
void device_open(pdd) /* open a device */ 
register DEV_DAT *pdd; /* pointer to device data */ 


register SERIAL *ps; /* pointer to SERIAL struct */ 


ps = pdd->base; /* get shorter pointer */ 
inp(&ps->rtbl) ; /* empty receive data buffer */ 
inp(&ps->line_stat) ; /* clear status flags */ 
if (pdd->stat_drv & HHS) /* if hardware handshake */ 
{ 
if ((inp(&ps->modem_stat) & (DSR | CTS)) == (DSR | CTS)) 
pdd->stat_drv &= “SWAIT; /* mark as ok */ 
else pdd->stat_drv |= SWAIT; /* mark as not ok «/ 
outp(&ps->iebh, ENA_REC | ENA_MOD) ; /* receive, line & modem */ 
; 
else outp(&ps->iebh, ENA_REC) ; /* just receive and line */ 
pdd->stat_drv &= “DEV_OFF ; /* driver state = online */ 
imask(pdd->pic, pdd->ir_bit, ON); /* clr the interrupt mask */ 
outp(&ps~->modem_ctrl, DTR|RTS|OUT2) ; /* set modem control bits */ 
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The function ser_out provides a single location for maintaining or restarting 
interrupt-driven transmissions. It also provides a method for software hand- 
shake characters to preempt normal data transmissions. To prevent continuous 
interrupts, when the output buffer is empty, the transmit interrupt is disabled. 


JCC OSI ORI OI OCICS IORI OIC iio IG OG IG kick kek ae kok tic ieac ack ak set / 


/* ser_out() - transmit interrupt startup and maintenance 
JRO IORI ICICI IG Gok ok dk ok ok dokokok uk kk icdosakok kode kook ok ak kok ok kak ok leak ake ake / 


ser_out (pdd) 

register DEV_DAT *pdd; 
{ 

register SERIAL *ps; 


char c; 
int flag; 


ps = pdd~>base; 

if (inp(&ps->line_stat) & 0x20 && 
(inp(&ps->modem_stat) & DSR || 
!pdd->req_dsr)) 

t; 


if (pdd->stat_drv & F_XOFF) 
4 
pdd->stat_drv &= ~F_XOFF; 
ca ROFF; 


else if (pdd->stat_drv & F_XON) 
{ 
pdd->stat_drv &= ~F_XON; 
C=. RAIN: 
cia 4 
} 
else if(!(pdd->stat_drv & SWAIT)) 
{ 


flag = rb_out(pdd->prbo, &c); 
if(flag > -1) flag = 1; 

else 

{ 


flag = QO; 


* 


/* pointer to device data 


/* pointer to SERIAL struct 
/* character to transmit 


/* get shorter pointer * 


/* if terminal ready 


/* or dsr not required 


/* pending x-off request 7? 


/* clear pending flag 
/* send x-off 


/* pending x-on request ? > 


/* clear pending flag 
/* send x-on 


/* terminal ready 


/* request character to send > 


/* character to send 7 
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“/ 


“/ 


“/ 
*/ 


«/ 
*/ 


*/ 


+ 
device_close(pdd) ; 
return; 
} 
} 
, 
else flag = 0; 
} 
else flag = 0; 
if (flag) 
( 
/* enable transmit int */ 
outp(&ps->iebh, inp(&ps->iebh) | ENA_THE) ; 
outp(&ps->rtbl, c); /* output character */ 
} 
else /* disable transmit int */ 


outp(&ps->iebh, inp(&ps->iebh) & ~ENA_THE) ; 
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The function restart tests the interrupt enable register to determine if inter- 
rupts are currently enabled. If they are not, it calls ser_out to restart interrupt- 
driven transmissions, 


[ROC ROR OI IO ICO ICI ICI ISICI ICI ICICI HCAS Cc 3: dc ok a 2k ok ok ake ak e ak oe at ok akc ac ak ke ak ae ok ak ake / 


/* restart - attempt to restart interrupt-driven serial transmissions */ 
JO Rokk kok kok kg ok kokok doko koko dod ak kok doko ok ak ok kook ak ke ok ok ak ak ok ake ok ok ook otek / 


void restart (pdd) /* restart serial output */ 
register DEV_DAT *pdd; /* pointer to device data */ 
{ 
int flag; /* temporary */ 
if (! (inp (&pdd->base~->iebh) & ENA_THE)) /* need to restart ? */ 
flag = int_off(Q); /* CPU interrupts off */ 
ser_out (pdd) ; /* restart */ 


int_on (flag) ; /* allow interrupts */ 
& k 
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ate” Hay 
‘ 


an 


The functions coml int, modem int, and printer int are interrupt handlers for 


the serial devices. These interrupt handlers call a common interrupt handler, 
device int. 


JOO Coleg aloo edo doe gdiietoiigtciiogiciicktok otokoioidadciaiciocicdedeetove sc ic dee ie ak sk keake ake ake ae ke / 
/* comi_int() - interrupt handler for com1 serial device x / 
JRC OO doko doe od k i Ok ok lok ici ak ale kode si kOe ake a akc ake ake ak ake ake akc ae ke okt ok ofc oe ake ee ake ae ake / 
void com1_int() 
{ 
extern DEV_DAT devdat[]; 
void device_int(); 

device_int (&devdat[0]); /* call common interrupt handler */ 
} 
JOC do oidiglok dol ecicigcioioloo ogc ioigdcioogoigdcdaicdoioiotokadokok ak ded de sede dese ak aed ak ae ste / 
/* modem_int() - interrupt handler for modem serial device * / 
JOG ooo dock dodooick do oick dod ok iodo ck de uc ok dodo ak keaton ak ake dea fe ak ake ake oe oe ake ake / 
void modem_int () 
extern DEV_DAT devdat[]; 
void device_int(); 


device_int (&devdat[1]); /* call common interrupt handler */ 


{kk Ok oko kkk dokodokokkokokokodokodededkogkdkkokododokockok dokadokodokok dedodokokukok dk sk kook skool desk kak desk dose dk de dkeok ff 
/* printer_int() - interrupt handler for printer serial device */ 
OOOO oi bid aiok dalek / 
void printer_int() 

extern DEV_DAT devdat[]; 


device_int (édevdat[3]); /* call common interrupt handler */ 
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The function device_int is the major function within the device driver. It 
coordinates interrupt processing, handshake protocol, and peripheral interrupt 
controllers. For any given serial device, this function processes all pending in- 
terrupts during a single CPU interrupt. This reduces the CPU interrupt proc- 
essing’ overhead. 


Device communication errors are noted by placing a question mark in the input 
stream. 


The switch values are tested against the contents of the interrupt identification 
register. 


[DOC OOC O  RIORIO OGIO RGR ORO doi a dak kok kk ak kok deok ica ask / 


/* device_int() - interrupt handler for serial device * f 
void device_int (pdd) /* interrupt handler */ 
register DEV_DAT *pdd; /* pointer to device data */ 
4 
register SERIAL *ps; /* pointer to SERIAL struct */ 
unsigned char r_val; /* register value read */ 
ps = pdd->base; /* get shorter pointer */ 
while (!((r_val = inp(&ps->int_ident)) & 1)) /* while int pend */ 
i 
switch(r_val) /* discover which interrupt */ 
{ 
case 6: /* receive error int */ 
inp(&ps->line_stat) ; /* clear error */ 
if (inp(&ps->modem_stat) & DSR | | /* if terminal ready */ 
!pdd->req_dsr) /* or dsr not required */ 
{ 
rb_in(pdd->prbi, °?’); /* show error */ 
} 
break: 
case 4; /* receive data ready int */ 
r_val = inp(&ps->rtbl) ; /* read character */ 
if (inp(&ps->modem_stat) & DSR || /* if terminal ready */ 
!pdd->req_dsr) /* or dsr not required */ 
{ 
if ((pdd->stat_drv & HHS) == 0) /* software handshake 7? */ 
{ 
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case X_OFF: /* x-off character 7? */ 
pdd->stat_drv |= SWAIT; 
break; 


case X_ON: 
pdd->stat_drv &= ~SWAIT; /* x-on character ? */ 
restart (pdd) ; 
break; 


default: 
if (rb_in(pdd->prbi, r_val) < 1) /* save character */ 
{ /* if buffer near full */ 
pdd->stat_drv |= F_XOFF; /* stop input */ 
restart (pdd) ; /* restart if needed */ 
, 
break; 
} 
} 
else if(rb_in(pdd->prbi, r val) < 1) /* save character */ 
outp(&ps->modem_ctrl, DTR | OUT2); /* no input please */ 
} 
break; 
case 2: /* xmit hold reg empty int */ 
ser_out (pdd) ; /* transmit character */ 
break; 
case 0: /* modem status int */ 
if (pdd->stat_drv & HHS) /* hardware handshake ? */ 
if ((inp(&ps->modem_stat) & (DSR | CTS)) == (DSR | CTS)) 
{ 
if (pdd->stat_drv & SWAIT) /* send stopped ? */ 
{ 
pdd->stat_drv &= “SWAIT; /* mark as ok */ 
restart (pdd) ; 
} 
; 
else pdd->stat_drv |= SWAIT; /* mark as not ok */ 
break; 
} 
} 
eoi(pdd->pic) ; 
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The function device close disables all interrupts related to the device indicated. 
It also puts the modem control lines in an off-line state. 


/ Poole ale Sle ole she fe te she ofc se te abe ole ode oe oc ahs le fe fe ole ofc fe ake ofc fe ole ofe ode ote he ake ok ot ok Fe oe ake ake oe ie ot He oe fe oe oe Me fe oe oi ote oe ic 2 of oh ke ok ofc ok ke oie fe oe ole of oe of oe ke / 


/* device_close() - deactivate serial port interrupts & f 
{Rk kkk ko ok kook aR kK a a IG ok kk ok ake ak sk 2k ok kk sk ok i aki ak ke ake ok ok ok ke ok dak ai ok ocak ok akc oe akc oc oe ke ake ote ake ok 


void device_close(pdd) /* close a device */ 


register DEV_DAT *pdd; /* pointer to device data */ 


outp(&pdd->base->modem_ctrl, 0); /* device offline */ 

outp(&pdd->base->iebh, 0); /* 8250A UART interrupts off 
* 

imask(pdd->pic, pdd->ir_bit, OFF); /* mask the interrupt */ 

pdd->stat_drv |= DEV_OFF; /* driver state = offline */ 


} 


© 
a) 
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The function put buf loops until it has stored the indicated character in an 
output buffer. After storing the character, it ensures that the transmit inter- 
string by calling put buf at each character in the string. The null terminator is 
not processed. 


DCR GIO IOI IOI IO IG OOOO RG ik kok ak ok ak a A ak ake ak ak ake ake ak ak ak aca / 


/* put_buf() - put character in output buffer + / 
GOGO OIG CIO OSGI OGIO COCO ICICI III I IR i ak kk ok ak ak kak ak ake / 


void put_buf(pdd, c) /* put char in output buf */ 
register DEV_DAT *«pdd; /* pointer to device data */ 
char c; /* char to put in buffer */ 


{ 


int flag; /* temporary */ 
intr val: 


for(flag = -1; flag < 0;) /* wait until success */ 
{ 
flag = rb_in(pdd->prbo, c); /* attempt to store */ 
restart (pdd) ; 
} 
} 


/ CRORE I OOIOI OR IC G Gk ga ak ok dak ok ok ak ok ak ake ok ak ake ake ake ak akc / 
/* puts_buf() - put string in to output buffer */ 


JOGO OOO Oi kokokokok kok dokcdokok kk kok ick i koi IO OR dO OR IO oi i te ok i tee tte ate ae ae ae / 


void puts_buf(pdd, pc) /* string into output buf */ 
register DEV_DAT *pdd; /* pointer to device data */ 
char *pc; /* pointer to string */ 


{ 


int flag; 


while(*pc) /* while string not done */ 
put_buf(pdd, *pctt); /* do another character */ 
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The function get buf attempts to retrieve a character from the input buffer. If 
no characters are available, it returns a -1 value. It also handles the input 


handshake protocol. 


JDO OGIO IC OI ICICI RIC IOI I IO IO I I ci k kok ke ak ak ak i a a oa acai ke keke ake ake // 


/* get_buf () 


- get character from input buffer +f 


JRO Rk 2 oe ok ok ae kee ke ake ote ake ic se aici oe eke fe ake ke ke akc oe ake ake fe ake oft ake ode fe ke ake abe ake ale ake ake aft ake ake fe a ake fe as ake fe oe ale oe ake abe ake ats ake te ake / 


int get_buf (pdd) 
register DEV_DAT *pdd; 
{ 


char c; 
int flag; 


flag = rb_out(pdd->prbi, &c); 
if(flag < 0) return(flag) ; 
if(flag == 0) 
4 
if (!(pdd->stat_drv & HHS)) 
< 
pdd->stat_drv |= F_XON; 
restart (pdd) ; 
} 


/* get char from input buf */ 


/* pointer to device data */ 


/* temp to hold character */ 


/* get char from input buff */ 
/* no characters available */ 
/* room to restart flow ? */ 
/* and receive stopped */ 

/* software handshake ? */ 


/* set x-on flag */ 


else outp(&pdd->base->modem_ctrl, DTR|RTS|OUT2) ; 


} 
flag = c; 
return(flag & Oxff); 


/* return character */ 


/ OIG IGOR OG IG OIG I I III CHOC ICC ok ke ake ake ake i ok ok oc aks ake ke ois ac oe ake ake ake ke ake ae ae akc ake / 


/* reserve storage for variables used in example serial driver * f 
CGR ROO IO III ICC OG GO doi SIG ok a a I I i dea ak ak ok ak ak ak ak ie ake ake ake akc ok ke akg ake ae ate ake / 


#define BUF_SIZ 100 
#define HIWATER 75 
#define LOWATER 25 


#define COMi1 (SERIAL *)0x03f8 
#define MODEM (SERIAL *)0x02f8 


#define PRINTER (SERIAL *)OxOCAO 


RING_BUFF rb[6]; 
char buff[3] [2] [BUF_SIZ]; 
DEV_DAT devdat[3] = 


/* size of buffers */ 
/* buffer near full value */ 
/* buffer near empty value */ 


/* base address of comi */ 
/* base address of modem */ 
/* base address of printer */ 


/* ring buff ctrl structs */ 
/* ring buffers */ 
/* device data tables */ 
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4 


{ COM1, 0, 4, 9600, 8, NO_PAR, O, 1, &rb[O], &rbfil, 0 }, 
{ MODEM, 6.3 1200, 6, NOLPAR,.:.9; 1, &rb[2], &rb [31,0 F, 
{ PRINTER, 1, 3, 4800, 8, NO_PAR, O, O, &rb[4], &rb f51, Oo}, 
be 
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ata SNARE AASNNO 


The function so drives the examples by transmitting or receiving serial data. It 
initializes the devices and data structures, executes the example and then 
closes the device. 


JOO Io ook OIG OG oi iokok a dokok a ick dak kick ake ak sk kek ak ake ak kak ac ake ae / 


/* so() - example application that uses serial driver | 
JDRF OR ORO ICR RIGOR I IO TO ICI IOI IOI IOI I a I CI CII OIC IO IOI ace fe ake ok ake ok ake akc ake ake ic akc ok // 
so() 
{ 
static MESSAGE mso[] = /* opening menu */ 
{ 

{ 3, 25, "Serial Communications Example" }, 

{ 5, 24, "Fi. Select the COM1 port" }, 

{ 6, 24, "F2. Select the Modem (COM2) port" }, 

{ 7, 24, "F3. Select the Printer port" }, 

{ 8, 24, "F4. Transmit sample data" }, 

{ 9, 24, "F5. Receive data" }, 

{ 10, 24, "F100. Return to Main menu" }, 

4-0, ©;: 0.7; 
a 
register DEV_DAT *pdd; /* pointer to device data */ 
int. i /* loop control */ 
int s; /* loop control */ 
int col; /* display position */ 
int flag; /* hold state of CPU IF */ 


char line[512] ; 
unsigned int intr_flag; 


for(i = 0; 


i < 2: i++) 


/* to hold input line 


/* to hold CPU IF state ~* 


/* get pointer to data * 


init_rb(pdd->prbi, &buff[i] [0] [0], BUF_SIZ, HIWATER, LOWATER) ; 


{ 
pdd = &devdat[il; 
if (pdd->pic == 0) s = 0x08; 
else s = 0x70; 
intr_flag = int_off(); 
iv_init(s + pdd->ir_bit); 
device_init (pdd) ; 
device_open(pdd) ; 
int_on(intr_flag) ; 

} 

line[O] = 0; 

while(1) 

{ 
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ad 


/* base vector for master pic * 


/* base vector for slave pic 


/* no interrupts allowed * 
/* init interrupt vectors * 


/* init serial device 


/* activate device * 
/* allow interrupts * 


/* null line * 
/* forever until F10 * 
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if (get_key(&line[0])) /* scan code */ 
while(!get_key(&line[1])) /* character code */ 


disp_menu(mso) ; /* display menu for serial example */ 
line[O] = get_fkey(); /* get menu selection */ 
il switch(line[0]) /* which function key ? */ 
{ 
case F1: /* select comi port */ 
pdd = &devdat [0]; /* get pointer to data */ 
break; 
case F2: /* select modem (COM2) port */ 
pdd = &devdat[1] ; /* get pointer to data */ 
break; 
case F3: /* select printer port */ 
pdd = &devdat[2] ; /* get pointer to data */ 
break; 
case F4: /* transmit sample text */ 
disp_str(1i4, 0, "Press F4 again to cancel"); 
i= OQ; 
while(line[O] != 0 || line[1] != F4) /* F4 terminates */ 
< 
sprintf (&line(0], "This is line %d\r\n", i++); 
puts_buf(pdd, line); 
disp_str(15, 0, line); 
chk_dt () ; /* display date and time 7? */ 
if (get_key(&line[0])) /* scan code */ 
while(!get_key(&line[1])) /* character code */ 
} 
break; 
case FO: /* receive serial data */ 
disp_str(14, 0, "Press F5 again to cancel") ; 
col = QO; 
while(line[O] != 0 || line[1] != FS) /* F5 terminates */ 
{ 
i = get_buf (pdd) ; 
if(i > -1) 
a 
i & Ox7f; 
disp_t(16, col++, i, 0x07); 
Cg if(i == '\r’ || i == '\n’) col = 0; 
= if(col == 80) col = 0; 
} 
chk_dt() ; /* display date and time ? */ 
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} 


break; 


case Fi0: 
for(i = 0: i < 3; itt) 


{ 


ll 


pdd = &devdat[i] ; 
device_close (pdd) ; 
if (pdd->pic == 0) s = 0x08; 
else s = Ox70; 
intr_flag = int_off(); 
iv_rest(s + pdd->ir_bit); 
int_on(intr_flag) ; 

: 


return: 


/* get pointer to data 

/* close device when done 

/* base vector for master pic 
/* base vector for slave pic 
/* no interrupts allowed 

/* restore interrupt vectors 
/* allow interrupts 
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*/ 


Chapter 10 
Mouse Information 


Introduction 


The VAXmate mouse (part number VSX XX) is a pointing device with three 
input switches. The mouse has two encoders, one for the X axis and one for 
the Y axis. The encoders have a resolution of 200 counts per inch. When 
moved on a flat surface, the mouse monitors the motion relative to its position 
at the beginning of the motion. Thus, the mouse maintains positional data in 
the form of incremental X/Y encoder counts. Figure 10-1 shows the mouse in 


relation to its X/Y axes. 


+ Y-axis 


Figure 10-1 VAXmate Mouse (Part Number VSXXX) 
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Communication Requirements 


The mouse communicates through an asynchronous serial interface at 4800 
baud. 
Data bytes have the following format: 


e 1 start bit 


¢ 8 data bits (least significant bit first) 


¢ 1 parity bit (the mouse transmits odd parity, but ignores receive parity 
errors.) 


e 1 stop bit 


If a byte is sent to the mouse while the mouse is transmitting, the mouse 
aborts the transmission and processes the new command. If the mouse receives 
a byte between the characters of a multibyte report, the mouse is considered to 
be transmitting and aborts the report. 


The VAXmate workstation communicates with the mouse through an 
asynchronous serial interface (Signetics SCN2661 Enhanced Programmable 
Communications Interface). 


Additional Source of Information 


The Signetics’ document, Microprocessor Data Manual 1986, provides addi- 
tional information on the SCN2661. 


Mouse Commands 


The Table 10-1 lists the mouse commands. The commands are issued by 
transmitting the appropriate command code, 


ASCII HEX Function 

D 44H Prompt Mode 

R 52H Incremental Stream Mode 
r 50H Request Mouse Position 
gt 54H Invoke Self-test 

ZX 5AH xx Vendor Reserved function 


i ie men assent OG Si een ego HNO UNS SHneaeutiniin bonapmehtnte RNID SUR No mi ennai 
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10- 2 Mouse Information - Hardware Description 


“igi 4 


Prompt Mode 
Incremental Stream Mode 


The mouse has two operating modes, prompt mode and incremental stream 
mode. In prompt mode, which is the powerup default, the mouse generates a 
report in response to a request mouse position command. In incremental 
stream mode, whenever the mouse moves it generates a report of that move- 
ment. It also reports a change in button position since the last report. No 
report is generated when the mouse is motionless and no buttons have been 
changed. 


Request Mouse Position 


The mouse responds to this command by sending a position report and switch- 
ing to prompt mode. 


Invoke Self-Test 


The mouse responds to this command by executing a self-test and then sending 
a self-test report. Self-test leaves the mouse in the reset or powerup state. 
During the self-test, any data sent to the mouse is ignored until the last byte 
of the self-test report has been sent by the mouse. The 4-byte self-test report 
consists of a 2-byte identification code and a 2-byte status code. 


Vendor Reserved Function 


The vendor reserved function is a 2-byte command, the ASCII character ’Z’ 
followed by any printable character. This command allows vendors to add spe- 
cial mouse functions. Normally, these functions are for quality control. The 
manufacturer determines these functions, which may include transmitting spe- 
cialized reports. These commands may not include new modes. On completion 
of a vendor reserved function, the mouse must be restored to its previous state. 
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Mouse Reports 


The mouse can transmit two reports, a 3-byte position report and a 4-byte self- 
test report. 


Position Report - Byte 1 
7 6 5 4 3 2 1 0 


nnn en tug Arr tsoitonreomvasnrnnasninitarntrncsinateicayganici 


SIGN-X |SIGN-Y | 


Bit Description 


tesa Ranvier reiterate OPIN ores Onin linn tpiinieerpnv benoitcerrina HK 


masonic 


7 Always 1 
6-5 Always 0 
4 SIGN-X (Sign bit for X-axis displacement) 


0 = Negative X-axis displacement. 
1 = Positive X-axis displacement 
3 SIGN-Y (Sign bit for Y-axis displacement) 


0 = Negative Y-axis displacement 
1 = Positive Y-axis displacement 


2 LEFT BUTTON 
0 = Switch open 
1 = Switch closed 

1 MIDDLE BUTTON 
0 = Switch open 
1 = Switch closed 

0 RIGHT BUTTON 
Q = Switch open 
1 = Switch closed 


imines pennant iyi EDA rane ohn iii aoe ii nny iit ements tenant 
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Position Report - Byte 2 
7 6 5 P 3 2 1 0 
ito ee oe ee ee eee ee pe 


X-AXIS DISPLACEMENT 


sab sbinntnointmumaraeasitnninmre EE, SER (Meee CA CONTE RIS LE We meme ee Te 


Bit Description 


>is attanaenyetsinncrmanyeinosmineten amounts 


pipe Utena inns oilers eisai einem Hiren eetyegrNrasemne, 


7 Always 0 
6-0 X-AXIS DISPLACEMENT 


The X-axis displacement is measured in encoder counts (200 per 
inch). The value returned in this byte is the distance moved since 
the last report. In prompt mode, if reports are not requested often 
enough, this value can overflow. If an overflow occurs, no indication 
is given. Bit 0 is the least significant bit. 


‘wien hme EHS ONE IHRE en EU OHO MU eH ee GN set ee hare ction Mayenne atonement 


Position Report - Byte 3 


Fa 6 5 4 3 2 1 0 


Y-AXIS DISPLACEMENT 


sepa biciesapiegcenei es Laeegiarenaeeae: ee Le! LA Coe 
Bit Description 
7 Always 0 
6-0 Y-AXIS DISPLACEMENT 


The Y-axis displacement is measured in encoder counts (200 per 
inch). The value returned in this byte is the distance moved since 
the last report. In prompt mode, if reports are not requested often 
enough, this value can overflow. If an overflow occurs, no indication 
is given. Bit 0 is the least seceuapeoen bit. 


"mnemonic nasa ns UUASm eI emotion isnannn nei aes =n ete st Reema et eee eens eID ntti tenements aehuiivinmcee: 


at 
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Self-Test Report - Byte 1 
7 6 5 4 3 2 1 0 


FRAME SYNCHRONIZATION REVISION NUMBER 


Bit Description 


FRAME SYNCHRONIZATION 
These bits are always 101. They provide a means of detecting the 
first byte of a self-test report. 

4-0 REVISION NUMBER 


This is a hardware and software revision number for this design 
cycle. 


seamen iainnus tenn nuponsaimecoentnnen ey eestor aeons itn in MU aroun ain ito HOt ein nen grea omcomnii eter ere esa eo arose OSes MOINS eG tio 
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Self-Test Report - Byte 2 
7 6 5 4 3 2 1 0 
ap 


MANUFACTURERS ID DEVICE CODE 


0 0 - 0 


ec Snsiniterinl Scisscebliteacetpiane Leica ad etna be sencachea te otisce ee eee: LC eae eee eee os Seah eee eee 


Bit Description 


7 Always 0 
6-4 MANUFACTURERS ID 


3-0 DEVICE CODE 
Always 0010 


enone ARO Inte Cs in trie Hain HN NW Si WH i renner ori nee eA 
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Self-Test Report - Byte 3 
Ps 6 3. 4 3 - 1 0 
i =f oe fe ee ee ee ee | 


ERROR CODE 


4 q 
nateetrcecsannsiaemnenncimmet in me nmonmmmnominnisi te a ones sion nnn tomes ienonnttinimmnne 


Bit Description 


f Always 0 


6-0 ERROR CODE 
OOH = No error 
3EH = RAM or ROM checksum error 
3DH = Button error 


“enero ieraoneiiihormesr ntti ‘wi wien ea ntenercnerin dni tonne dannii amir tin ronrnesnmnonneonnsey muting strate enmity nuaiaawrcmennth 


Self-Test Report - Byte 4 
7 6 5 4 3 Z i 0 


Bit Description 


7-3 Always 0 
2 LEFT BUTTON 

0 = Switch good 

1 = Switch closed or failed 
it MIDDLE BUTTON 

0 = Switch good 

1 = Switch closed or failed 
0 RIGHT BUTTON 
0 = Switch good 
1 = Switch closed or failed 


-tno enor Ameen pm oie eet nme cnn heh yo minnesota ace pentane neHeMeeR 
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Serial Interface 


The serial interface is a SIGNETICS SCN2661 Enhanced Programmable 
Communications Interface. Table 10-2 lists the input/output (I/O) ports that 
access the serial interface registers. 


Table 10-2 Serial Interface Registers 


siciiiineenseeanunieannyne meena eternity asennad inmyname inincoiiiamaieinmenninipiniiincinsn pip eeu nto inserter 


Address R/W Register 


sanity Ey meee DEEN eset a N/a Oo ea hn iii iit po eterno 


OC40H R Receive buffer 
| Transmit holding register 


0C41H Status register 


R 

WwW Synl/Syn2/DLE registers * 

0C42H R/W Mode register 1 and mode register 2 ** 
0C43H R/W Command register 


so niaeunsommeneeoub eens 


43 The Synl, Syn2, and DLE registers are not used. 


sit soonest yen oa tenorecenoiynts torneo nse ean 


vaonannnes 


onannensincrnmnnmat neice 


annonce iNT ase inteoinpntanaisii 


** Mode registers 1 and 2 are accessed at the same I/O address. Read 
mode register 1 and then read mode register 2, or write mode register 
1 and then write mode register 2. Mode register 1 must be accessed to 
access mode register 2. 


Transmit Holding Register and Receive Buffer (0C40H) 
7 6 iB. 4 3 2 1 0 


TRANSMIT OR RECEIVE DATA 


Bit R/W_ Description 
7-0 R Accesses the receive data buffer 
W Accesses the transmit holding register 


draenei Meco es eas issn tintin teint teint eee Pel nome Pan 


2pm BPN eHow AWoeneiniitiniiinerntintmmeet reining onnnnanninsriMonshinsisantenesariiiiib uy onisnnnncinimdaeiionbne 
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Status Register (0C41H) 


6 5 4 3 Z 1 0 


7 R 
6 R 
5 R 
4 R 
3 R 
Z R 
1 R 
0 R 


DATA SET READY (always 1} 


DATA CARRIER DETECT (always 1) 


FRAMING ERROR 
Q = Normal 
1 = Framing error 


This bit is cleared by disabling the receiver, issuing the reset error 
command, or reading the status register. 


OVERRUN 
Q = Normal 
1 = Overrun error 


This bit is cleared by disabling the receiver or issuing the reset 
error command, 


= Parity error (if parity checking is enabled) 


This bit is cleared by disabling the receiver, issuing the reset error 
command, or receiving another character. 


DATA SET READY CHANGED (always 0) 


RxRDY - Receive Data Ready 
0 = Receive buffer is empty 
1 = Receive buffer contains data and an interrupt is pending 


This bit is cleared by reading the receive buffer or disabling 
the receiver (command register bit 2). 


| = Transmit holding register empty and an interrupt is pending 


This bit is cleared by writing the transmit holding register or dis- 
abling the transmitter (command register bit 0). 


iia aaa elec ce ca intamnnemengngneenedeemmmmemaneer eoeememmememmmemaedaremamammenmea scaemmemmmanieremammermammunermmmmmoli mum tourna mee 
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Mode Register 1 (0C42H) 
7 6 B .2 4 ie 2 1 0 


MODE AND BAUD 
RATE FACTOR 


PARITY | CHARACTER 
| CONTROL | LENGTH 


vont pital eansaatnamiaes (ici teaasteck eee: See eee 


Bit R/W_ Description 
7-6 R/W STOP BITS 
OO = Invalid 
01 = 1 stop bit 
10 = 1-1/2 stop bits 
11 = 2 stop bits 


5 R/W PARITY TYPE 
Q = Odd parity 
1 = Even parity 


4 R/W PARITY CONTROL 
Q = Parity checking disabled 
1 = Parity checking enabled 


3-2. R/W CHARACTER LENGTH 
00 = 5 bits 
O01 = 6 bits 
10 = 7 bits 
11 = ‘8 bits 


1-0 R/W MODE AND BAUD RATE FACTOR 
00 = Synchronous 1 X rate 
01 = Asynchronous 1 X rate 
10 =~ Asynchronous 16 X rate 
11 = Asynchronous 64 X rate 


“crassa iwiitestRgynAeieiesebiVASivaninsintin Soe airHnnpnnienoniiee nae tp ORUMYRAA Ati SHINONR RADIO iit intergenic ne ec et en Dee neuen HENDON 


iis vente eos US ye gH ie ities en ese Annee RNSRINOe 


sAisiotiireteinomenonseie 


Mode registers 1 and 2 are accessed at the same I/O address. Read mode regis- 
ter 1 and then read mode register 2, or write mode register 1 and then write 
mode register 2. Mode register 1 must be accessed to access mode register 2. 


When programming mode register 1 on the VAXmate workstation, use a value 
SEH. 
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Mode Register 2 (0C42H) 
7 6 > 4 3 2 1 0 


ee ee eg ee ee 


BAUD RATE 


acme, Ce, ua meal all 


RECEIVE AND TRANSMIT 
CLOCK SOURCE 

| Oo 1 1 1 

PGE RES (Pee, Sea aTe 


TES: DT SE, LAREN TE Lorene See 


Bit Description 
7-4 RECEIVE AND TRANSMIT CLOCK SOURCE 
For the VAXmate workstation hardware, this value is fixed. 


3-0 BAUD RATE 
See Table 10-3 


essing ints in Wee bn ono aetna ASS smi nei emetic Mites onan ieee Pie cn arrestee oR HED seo A einen pe 


Mode registers 1 and 2 are accessed at the same I/O address. Read mode regis- 
ter 1 and then read mode register 2, or write mode register 1 and then write 
mode register 2. Mode register 1 must be accessed to access mode register 2, 


When programming mode register 2 on the VAXmate workstation, use a value 
TCH. 


Table 10-3. Baud Rate Table 
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Command Register (0C43H) 


Bit R/W 
7-6 R/W 


9) R/W 


2 R/W 


0 R/W 


“increment neers Wt mene ONAN osetia sienna minions easement innominate envanerygiteeenenmnsnete inna niOn ADAG 


6 5 4 3 v4 1 0 


Description 


‘ena cant eNOS eich PW teense Snowe isin nee AIH NOE eu iets ee tems Ra sini una tttecae IRe mS cem 


OPERATING MODE 

00 = Normal operation 

01 = Asynchronous (automatic echo mode) 

10 = __ Local loop back 

11 = Remote loop back 

REQUEST TO SEND 

) = Force request to send output high (disables interrupt buffer) 
1 = Force request to send output low (enables interrupt buffer) 


The 2661 EPCI has a buffer 

between the interrupt output line and the peripheral interrupt con- 
troller input. This buffer is controlled by bit 3. Enabling the buffer 
enables the 2661 EPCI interrupt output line. 

RESET ERROR 

Always 0 


0 = No effect 

1 = Reset error flags (parity, framing, overrun) 
SYNCH/ASYNCH 

Q = Normal 

1 = Force break 

RECEIVE CONTROL 

Q = Disable receiver, receive interrupt, and status register bit 1 
1 = Enable receiver, receive interrupt, and status register bit 0 


DTR - Data Terminal Ready (output not connected) 
0 = Force data terminal ready output high 
1 = Force data terminal ready output low 


bit 0 
1 = Enable transmitter, transmit interrupt, and status register 
bit 0 


When programming the command register on the VAXmate workstation, use a 
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base value of 30H. In addition to the base value, bits 0 and 3 (transmit and 
receive control) must be applied as required. 


We 
ee 
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Programming Example 


The mouse programming example demonstrates: 
i ete J 


Communicating with the mouse 
Interpreting the motion 
ripe eugene the buttons 


* @€ @ @ 


The example provides routines as described in the following list: 


mouse_init Initializes the SCN2661 serial interface. 
mouse_open Prepares the serial interface for interrupt driven 
communications. 

send_to_ mouse Sends commands to the mouse. 

mouse_int Is the serial interface interrupt handler. 
mouse_close Deactivates the serial interface. 

mouse Executes the example program. 

JAUTION 


Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 


The include file rb.4 defines the ring buffer structure used in the serial inter- 
face interrupt handle The include files kyb.A and example.h support the exam- 
ple, but are not pertinent to the mouse section. 


The constant value eens etraiy defines the base address of the serial inter- 
face. The constant values MOUSE _ PIC through MOUSE H WI define the in- 
terrupt controller, interrupt input line, and the interrupt vector for the serial 
interface. 


The constant values MMODE through CMND REG define bit values for the 
serial interface registers. The constant values SEL F TEST through POS REP 
define the mouse command bytes. Finally, the constant values TESTMASK 
through BUTTON ERR define various values used in deciphering the mouse 
reports. 
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#include "rb.h" 
#include "kyb.h" 
#include "“example.h" 


JRO III IOI I COR IR IO a ok ok ok oe ok ok ac ok ok oe a ae ake akc fe ake ake ake ake kak ake ake ake ake ake ake ake / 


/* define constant values used in example mouse driver * / 
[ROO ROR OOO RO IO RC IC ok ok ak ok ak ok ok ok ak ak kk ake ak i ake kc ake akc oko oe aks ak ake akc ake akc ake oc ac ak ke oft ake aks fe fe ak aks ake ake ate te ake ake ake / 


#define MOUSE_PORT (MOUSE_UART *) 0x0C40 /* base address of mouse */ 
#define MOUSE_PIC 1 /* PIC that handles mouse */ 
#define MOUSE_INT 4 /* mouse int request line */ 
#define MOUSE_HWI 0x74 /* harware int vector location */ 


/* SCN2661 mode register bit values */ 


#define MMODE 0x02 /* Aynchronous 16X rate */ 
#define P_ENAB 0x10 /* Enable parity */ 
#define P_EVEN 0x20 /* Even parity select */ 
#define P_ODD 0x00 /* Odd parity select */ 
#define WORD8 0Ox0OC /* 8 bit characters */ 
#define WORD7 0x08 /* T bit characters */ 
4 #define WORD6 0x04 /* 6 bit characters */ 
tll #define WORDS 0x00 /* 5 bit characters */ 
#define S_BIT1 0x40 /* One stop bit */ 
#define S_BIT2 0Oxco /* Two stop bits */ 
#define BD4800 0x0C /* 4800 baud */ 
#define CLKSPC 0x70 /* 16X clock */ 


/* SCN2661 status register bit masks */ 


#define THRE 0x01 /* Transmit holding register is empty */ 
#define RDRDY 0x02 /* Receive holding register is full */ 
#define ERRORS 0x38 /* Parity, overrun or framing error */ 
#define PARITYERR Ox08 /* Parity error */ 
#define OVERRUNERR Ox10 /* Overrun error */ 
#define FRAMINGERR 0x20 /* Framing error */ 
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/* SCN2661 command register bit values */ 


#define TxEN Ox01 /* Enable transmit control */ 
#define DTR 0x02 /* Disable data terminal ready */ 
#define RxEN 0x04 /* Enable receive control */ 
#define BREAK 0x08 /* Disable break */ 
#define RESET 0x10 /* Enable reset status */ 
#define RTS 0x20 /* RTS (normally on) */ 
#define CMODE OxCO /* Command mode (normally 0) */ 
#define CMND_REG RTS|RESET|RxEN /* normal operation, RTS=1, rec enabled +/ 
/* Define mouse commands */ 

#define SELF_TEST 'T’ /* self-test command */ 
#define P_MODE 2 /* prompt mode */ 
#define I_S_MODE ’R’ /* incremental stream mode */ 
#define POS_REP  'P’ /* request position report */ 
/* These values are used to check the mouse */ 

#define TESTMASK Oxe0 /* mask any header byte */ 
#define HEADER_BYTE 0x80 /* header byte indicator */ 
#define SELFTEST Oxa0O /* self-test header byte mask */ 
#define POSREP 0x80 /* position report header byte mask */ 
#define RIGHTBUTTON 0x01 /* right button mask */ 
#define MIDDLEBUTTON 0x02 /* left button mask */ 
#define LEFTBUTTON 0x04 /* middle button mask */ 
#define XSIGN 0x10 /* X-axis sign bit mask */ 
#define YSIGN 0x08 /* Y-axis sign bit mask */ 
#define ROMRAM_ERR Ox3e /* self-test byte # 2 error type mask */ 
#define BUTTON_ERR Ox3d /* self-test byte # 2 error type mask */ 
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JOR OIO OOO GIO OR OI OR I GIG CIO IOI I IORI GE IS i I a I sk ka i ak a ak ak ak ok ak ate / 
/* define structures used in example mouse driver * f 
Was JG GIOR GIO FOSS OR IO ICICI ICI OIG C IOI IC Gk sk aC aC ak ake akc ok ak sk ake ok ok ak akc akc ok akc ake ak ok a akc ake ke oe oe ae ake ake ae ak ake / 


typedef struct 
. 


unsigned char hr; /* transmit/receive holding register */ 
unsigned char status; /* status register */ 
unsigned char mode; /* mode register */ 
unsigned char command; /* command register *«/ 


} MOUSE_UART; 


typedef struct mouse_dat 

{ 
MOUSE_UART *base; /* base i/o address of device */ 
RING_BUFF *prbi ; /* pointer to input ring buffer structure */ 
RING_BUFF *prbo; /* pointer to output ring buffer structure */ 

} MOUSE_DAT; 


/ ROR tO a okokokoigdokok kok kgkkcio oak okok kok ak ok ok dod kok deka ke ok ak ak kok akc ake da aie ake / 
/* reserve storage for variables used in example mouse driver * f 
JRO OOO CIGIIOI OO GIS UO GIGI SOR IGRI III OI IGIGIOK gor ak a ek ok ak ak leak drake ak afeak / 
#define BUF_SIZ 100 /* size of buffers */ 
#define HIWATER 75 /* buffer near full value *«/ 
#define LOWATER 25 /* buffer near empty value */ 


RING_BUFF rb[2]; /* ving buff ctrl structs */ 
char buff[2] [BUF_SIZ]; /* ving buffers */ 
unsigned char cmnd_reg; /* value to write to command register */ 
MOUSE_DAT mouse_data = { MOUSE_PORT, &rb[0O], &rb[i] }; 


int quietmouse = OFF; /* mouse state flag */ 


~] 


Mouse Information - Programming Example  I[0- | 


oe 
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RGR OOO ICICI JOC OR IGG OR IOI GIO RO Ia Ik k dele a I i OI OI ke ake ak ok take acai ak / 


/* mouse_init() - establish a known state for the mouse and SCN2661i * f 
[DCR OR SO IO OR IGOR GIGI i kook aR I ik i a I a IOI aK ak 2k ok I a ak ke ake oe ak kc oie ok ake aie oko fe ake ake ae ake de ak ake // 


void mouse_init() /* initialize mouse and port */ 

: 

register MOUSE_DAT *pdd; /* pointer to mouse data */ 

register MOUSE_UART *ps; /* pointer to mouse struct */ 
pdd = &mouse_data; /* point to driver data */ 
ps = pdd->base; /* assign base address */ 


/* initialize ring buffer structures */ 
init_rb(pdd->prbi, &buff[0][0], BUF_SIZ, HIWATER, LOWATER) ; 
init_rb(pdd->prbo, &buff[1][0], BUF_SIZ, HIWATER, LOWATER) ; 

/* async 16x, enable parity, odd parity, eightbit data, one stop bit */ 
outp(&ps->mode, MMODE | P_ENAB | P_ODD | WORD8 | S_BIT1); 


outp(&ps->mode, BD4800 | CLKSPC); /* 16x clock, 4800 baud */ 
cmnd_reg = CMND_REG; /* init to normal contents */ 
outp(&ps->command, cmnd_reg) ; /* reset status errors */ 
} 
NOTE 
During the initialization process, it is possible to transmit or re- 


ceive garbage characters. The mouse initialization function does 
not account for this possibility. 


GOO IO SIO ICI OOOO io RO I ok ok ko gio icc kokok kok dees dededok ae aac / 


/* mouse_open() - activate mouse interrupts + / 
[DCO GIGI IGS IORI ICRI ICI III III RAK ak Ret ak ak a ae / 


void mouse_open() /* open the mouse */ 
{ 

imask(MOUSE_PIC, MOUSE_INT, ON); /* enable interrupt input */ 
} 
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[DRG IO OOO OIC OR GG IOI GI I ckok a GIO GI IR dk desk sk keds ak oak ake ake sk aka / 


/* gsend_to_mouse() ~- write data to mouse + / 
[DOIG IO ICICI IOI GR ISIC IOI RG OIG IC Ok Sk: aCe ake ake ae ake ake akc leaks akc ak ake ake ake afe ake ake ae oke / 


send_to_mouse(c) 


unsigned char c; /* byte value to transmit */ 


< 


register MOUSE_DAT *pdd ; /* pointer to mouse data * f 
register MOUSE_UART *ps; /* pointer to mouse struct */ 
int intrflg; /* hold state of CPU IF */ 
pdd = &mouse_data; /* point to driver data */ 
ps = pdd->base; /* assign base address */ 
while(rb_in(pdd->prbo, c) < 0 ) /* wait until stored in buffer */ 
intr_flg = int_off(Q); /* disable CPU interrupt */ 
cmnd_reg |= TxEN; /* to enable transmitter */ 
outp(&ps->command, cmnd_reg) ; /* enable transmitter */ 
int_on(intr_flg); /* enable CPU interrupt */ 
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7 a ook ok ok OR RII RR I I OR Ske oR ofc eC oe of ke oe oe ok akc fc ok fe ofc fe oe oe ae oe oe fe a ok oe ok ak akc kc ake akc ake ake oe ake oe akc ake oe ok okt / 


/* mouse_int() - interrupt handler for mouse serial port * | 
(DCI Ok oko IG ik ick koko aR a ok sk dedlok ak ok ak ak ake aca eae ake ake ale ake ok aks akc ak ak ake a te / 


void mouse_int() /* interrupt handler */ 
{ 

register MOUSE_DAT *pdd; /* pointer to mouse data */ 
register MOUSE_UART *ps; /* pointer to MOUSE_UART struct */ 


unsigned char c; 
unsigned char s; 


pdd = &mouse_data; 
ps = pdd->base; /* assign base address */ 


s = inp(&ps->status) ; /* read status of port */ 


if(s & (PARITYERR | FRAMINGERR) ) /* garbage character 7? */ 


s = inp(&ps->hr) ; /* read garbage character */ 
else if(s & RDRDY) /* is there anything to read ? */ 
{ /* read and store in ring buffer */ 


if (rb_in(pdd->prbi, inp(&ps->hr)) < 1 ) /* buffer getting full 7? */ 
4 
send_to_mouse(P_MODE) ; /* put mouse in prompt mode */ 
quietmouse = ON; 
} 
} 
if(s & THRE) /* ready to transmit ? */ 
{ 


if (rb_out (pdd->prbo, &c) < 0) /* any characters to transmit ? */ 
cmnd_reg &= TxEN; /* disable transmitter */ 
else outp(&ps->hr, c); /* write the character */ 

} 
outp(&ps->command, cmnd_reg) ; /* reset status errors */ 


eoi(MOUSE_PIC) ; /* send EOI to interrupt controller */ 


NOTE 
This routine could check for overrun errors, but it does not. 


Because each mouse report has a fixed byte count, missing char- 
acters are detected in the record collection part of the mouse() 
function, 
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| | /* mouse_close() - deactivate mouse port interrupts + / 
a {ORO FOO RIO IR kk a tok ak ok ok ok ak ok ak ok oko ok ak oie oc ok ok akc ak ok ok ois oe ok akc akc ake ake fe fe fe akc ake aks ae ofe ake ke oe ake / 
void mouse_close() /* deactivate the mouse */ 
{ 
register MOUSE_DAT *pdd; /* pointer to mouse data */ 
register MOUSE_UART *ps; /* pointer to MOUSE_UART struct */ 
pdd = &mouse_data; /* point to driver data */ 
send_to_mouse(P_MODE) ; /* put mouse in prompt mode */ 
while (pdd->prbo->count) /* wait until ring buffer empty */ 
cmnd_reg = CMND_REG & RxEN; /* disable receiver and transmitter */ 
ps = pdd->base; /* assign base address */ 
outp(&ps~>command, cmnd_reg) ; /* write new command */ 
imask(MOUSE_PIC, MOUSE_INT, OFF); /* disable interrupt input */ 
: 
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/* example application that uses mouse driver 
JORG IO kkk kok do koko kok doko kok doko gk koko doko koko kok RO GK doi kek kod ok aoa ake ok ok ak ak ok ak ak ak ake ake teak // 


mouse () 


{ 


static MESSAGE mmouse[] = 


{ 


/* mouse menu 


{ 3, 34, "Mouse Example" }, 

{ 5, 18, "Move the mouse to see X and Y displacements." }, 
{ 6, 16, "Move cursor to a box and select with left button." }, 
{ 8, 24, "[ ] End Mouse Example" }, 

{ 9, 24, "[ ] Increase X Scale" }, 

{ 10, 24, "[{ ] Decrease X Scale" }, 

{ 11, 24, "[ ] Increase Y Scale" }, 

{ 12, 24, "[ ] Decrease Y Scale" }, 

{ 14, 24, "Left button status: Up ©}, 

{ 15, 24, "Middle button status: Up " }, 

{ 16, 24, "Right button status: Up " }, 

{ 18, 24, "X encoder counts: Oo" }, 

{ 19, 24, "Y encoder counts: Oo" }, 

{ 20, 24, "X Scale: 12" }, 

{ 21, 24, "Y Scale: 52" }, 

{ 0, 0, OO}, 


se 
register MOUSE_DAT *pdd; 
register MOUSE_UART *ps; 


unsigned char 


i_buff [80]; 
] 


char o_buff [80]; 
char kb; 

unsigned char *pb; 
int row = QO; 

int tmp; 

int pos_rep = 0; 


int end_me = FALSE; 

int left button = FALSE; 
int buff_state; 

int x_abs = 40; 

int y_abs = 12; 

int x_cnts = 0; 

int y_cnts = 0; 

int x_scale = 12; 

int y_scale = 52; 

int moved = 0: 
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/* pointer to mouse data 


/* input buffer 
/* output buffer 


/* pointer to input buffer 


/* row position of cursor or text 


/* absolute position of cursor in 
/* absolute position of cursor in Y-axis 
/* accumulated X-axis encoder 
/* accumulated Y-axis encoder 


/* temporary variable 
mouse position report flag 
/* end mouse example flag 
/* state of left button 

/* input buffer state flag 
X-axis 


/+ 


counts 
counts 
/* encoder counts per column 

/* encoder counts per row 


/* flag to indicate that mouse reported motion 
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x f 


SEES ASEM RRL TERN ATR SSR BSCE TEP RENE FE RTA eos eNO aeemamaennnmvrenneraee 


int intr_flg; /* hold state of CPU IF * 
int cnt_req; /* byte count required for report 


extern int time_flag; /* defined in RTC example 


pdd = &mouse_data; /* get pointer to data 


ps = pdd->base; /* assign base address * 


intr_flg = int_offQ; /* disable CPU interrupt 


iv init (MOUSE_HWTI) ; /* init interrupt vectors : 
mouse_init(); /* init mouse * 
int_on(intr_flg) ; /* enable CPU interrupt * 


mouse_open() ; /* activate mouse 
send_to_mouse (P_MODE) ; /* ensure mouse is in prompt mode 


while(rb_out(pdd->prbi, &i_buff[0]) >= 0) /* while buffer not empty * 


/* dump characters 


a 
send_to_mouse(SELF_TEST) ; /* issue self-test command * 


intr_flg = int_off(); /* disable CPU interrupt 


time_flag = 0; /* reset RTC second flag * 


int _on(intr_flg) ; /* enable CPU interrupt 
for(tmp = 0; time_flag < 3 && tmp < 4; ) 
{ 


{ 
if ((i_buff[tmp] & TESTMASK) == SELFTEST)/* self-test header byte 
tmp = 1; /* first byte of report 
else if (tmp) tmp+t; /* additional report bytes 
} 
} 
tmp = 0; 


if (time_flag >= 3) /* check for time-out error * 


5! 


strepy(ko_buff[0], "Mouse time-out error”); /* error message * 
tmp = 1; /* set error indicator » 


} 


else if (i_buff[2] == 0x3e) /* check for mouse ROM/RAM error > 


{ 
strcepy(so_buff[0O], " Mouse ROM/RAM error"); /* error message 


cs ea /* set error indicator * 


} 


else if(i_buff[2] == 0x3d) /* check for mouse button errors : 


! 


strcpy(ko_buff[0], " Mouse button error"); /* error message * 


tmp = 1; /* get error indicator 


tap 


“ag og x %, 
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if (rb_out (pdd->prbi, &i_buff[tmp]) >= 0) /* try to read character * 


£ (tmp) /* test error indicator * 


disp_str(12, 35, &ko_buff[0]); /* show error message */ 
disp_str(13, 35, "Press Fi0 to continue"); /* show help message */ 
while(1) if(get_key(&kb) == 1 && kb == F10) break; 
} 
else 
{ 
disp_menu (mmouse) ; /* display the mouse menu */ 
cursor_on(y_abs, x_abs); /* make cursor visible */ 
send_to_mouse(I_S_MODE) ; /* reset to incremental stream mode */ 
cnt_req = ~-1; /* set byte count required to below zero */ 
pos_rep = FALSE; /* no position report yet */ 
pb = &i_buff[0]; /* initialize pointer to input buffer */ 
while(end.me == FALSE) 
{ 
chk_dt(); /* check date and time for update */ 
buff_state = rb_out(pdd->prbi, pb); /* try to read mouse */ 
if (buff_state >= 0) /* did the mouse send anything 7 */ 
{ 
if(*pb & HEADER_BYTE) /* is it a header byte ? */ 
< 
i_buffLlO] = *pb; /* move to beginning of buffer */ 
pb = &i_buff[1]; /* reset to next byte in input buffer */ 
if ((i_buff[0] & TESTMASK) == POSREP) /* discover header type */ 
{ 
cnt_req = 2; /* remaining count required */ 
pos_rep = TRUE; /* have header byte for position report */ 
} 
else /* anthing else is an error */ 
< 
cnt_req = -1; /* set byte count required to below zero */ 
pos_rep = FALSE; /* no position report */ 
} 
else if(pos_rep) /* if received a position report header byte */ 
4 
if(++pb > &i_buff[10]) /* increment buffer pointer */ 
{ /* if pointer test is true, unexpected error condition */ 
pb = &i_buff [0]; /* reset buffer pointer */ 
pos_rep = FALSE; /* cannot be a position report */ 
cnt_req = -1; /* set byte count required to below zero */ 
} 
if (--cnt_req == 0) /* end of report 7? */ 
{ 
/* get position increments */ 
moved = 0; /* clear mouse motion flag */ 
tmp = i_buff[1]; /* get X-axis increment */ 
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if(!(i_buff[0] & XSIGN)) tmp = -tmp; /* check sign bit */ 


x_cnts += tmp; /* accumulate X-axis encoder counts */ 
sprintf(o_buff, "44d", tmp); /* convert to a string */ 
disp_str(18, 42, o_buff); : /* show X-axis increment */ 
tmp = x_cnts / x_scale; /* enough to show motion 7? */ 
if (tmp) 
{ 
x.cnts -= x_scale * tmp; /* remove scaled counts */ 
x_abs += tmp; /*x add to absolute position */ 
if(x_abs < 0) x_abs = 0; /* no off-screen motion */ 
if(x_abs > 79) x_abs = 79; /* no off-screen motion */ 
moved = 1; /* set flag to update cursor position */ 
} 
tmp = i_buff[2]; /* get Y-axis increment */ 
if(!(i_buff[O] & YSIGN)) tmp = -tmp; /* check sign bit */ 
/* y-axis encoder counts are accumulated negatively to invert motion */ 
y_cnts -= tmp; /* accumulate Y-axis encoder counts */ 
sprintf(o_buff, "%4d", tmp); /* convert to a string */ 
disp_str(19, 42, o_buff); /* show Y-axis increment */ 
tmp = y_cnts / y_scale; /* enough to show motion ? */ 
if (tmp) 
{ 
y_cnts -= y_scale * tmp; /* remove scaled counts */ 
y_abs += tmp; /* add to absolute position */ 
if(y_abs < 0) y_abs = 0; /* no off-screen motion */ 
if(y_abs > 24) y_abs = 24; /* no off-screen motion */ 
moved = 1; /* set flag to update cursor position */ 
} 
if (moved) mv_cursor(y_abs, x_abs); /* update cursor */ 


/* display state of mouse buttons */ 


for(tmp = LEFTBUTTON, row = 14; row < 17; rowt++, tmp >>= 1) 


{ 
if(i_buff[0O] & tmp) disp_str(row, 46, "Down"); 
else disp_str(row, 46, "Up "); 
} 
if (i_buff[O] & LEFTBUTTON) /* test for valid selection */ 
{ 
if (‘left_button) /* must release button from last select */ 
{ 
left_button = TRUE; /* left button pressed */ 
if (x_abs == 25) 
{ 
switch(y_abs) 
{ 
case 8: /* end mouse example */ 
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end_me = TRUE: /* get to true 
break; 


case 9: /* increase X scale 

if (x_scale < 1000) /* arbitrary value 

x_scale += 2; /* arbitrary increment 
break; 


case 10: /* decrease X scale 

if (x scale > 2) /* cannot be zero 

x scale -= 2; /* arbitrary decrement 
break; 


case 11: /* increase Y scale 

if(y_scale < 1000) /* arbitrary value 

y_scale += 2; /* arbitrary increment 
break: 


case 12: /* decrease Y scale 
if(y_scale > 2) /* cannot be zero 
y_scale -= 2; /* arbitrary decrement 
break; 
} 
sprintf(o buff, "43d", x scale); /* convert 
disp_str(20, 33, o_buff); /* show new X-scale 
sprintf(o_ buff, "43d", y_scale); /* convert 
disp_str(21, 33, o_buff): /* show new Y-scale 


} 
} 


ae ri 


else left_button = FALSE; /* reset left button state—*/ 


pos_rep = FALSE; /* no position report 


} 


+ 
/* If mouse disabled because the ring buffer was full, turn it back on 
if(quietmouse && buff_state == 0) send_to_mouse(I_S_MODE) ; 
} 
} 
mouse_close(); /* close the mouse 
intr_flg = int_off(Q); /* no interrupts allowed 


iv_rest (MOUSE_HWI) : /* restore old vectors 
int_on(intr_flg) ; /* allow interrupts 


* 
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Chapter 11 
Diskette Drive Controller 


ntroduction 
The diskette drive controller interfaces the VAXmate system bus and the 
diskette drives. The diskette drive controller supports the following drives and 
media: 


Drive Type Media 


eacnnenstnnenomtrmsinanternaaaamnnnnninysinoMiaayarinnse mer MYN re stains tet wttvernrinantnenfretraoitn iinet Hens one psn Oa nse: 


54 Inch - High capacity 1.2 Megabyte - 80 Track - High capacity 
800 Kbyte - 80 Track - Standard 


360 Kbyte - 40 Track - Standard (with 
double stepping) 
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The diskette drive controller operates in either DMA or non-DMA made. In 
DMA mode, the processor initializes the DMA controller and issues the 
transfer command to the diskette controller. The diskette controller and the 
DMA controller transfer the data unattended. In non-DMA mode, the diskette 
controller generates interrupts to the processor each time the controller 
transfers a data byte. 
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Diskette Drive Controller Registers 


The diskette drive controller has five 8-bit registers that are accessed through 
four port addresses. Table 11-1 lists the registers. 


Table 11-1: Diskette Drive Controller Registers 


Address R/W Register 
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03F2H W Control register 
O3F4H R Main status register 
O3F5H R/W Data register 

03F6H W Transfer rate register 
O3F6H R Change register 
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Control Register (O3F2H) 
— y 6 5 A 3 2 1 0 


MOTOR B|MOTOR A|DMA | DRIVE 
| | SELECT 


Bit R/W_ Description 
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7-6 W Always 0 
5 W MOTOR B 
0 = Drive B motor off and disable bit 0 
1 = Drive B motor on and enable bit 0 
4 WwW MOTOR A 
Q = Drive A motor off and disable bit 0 
1 = Drive A motor on and enable bit 0 
3 W DMA ENABLE 
Q = Disable the diskette drive controllers DMA request, DMA ac- 
knowledge, and interrupt request 
1 = Enable the diskette drive controllers DMA request, DMA ac- 
knowledge, and interrupt request 
2 W RESET 
0 = Reset the diskette drive controller 
1 = Enable the diskette drive controller 
] WwW Always 0 
OQ W DRIVE SELECT 
Q = Select Drive A 
1 = Select Drive B 


This bit is enabled or disabled by bits 5-4. 
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Main Status Register (03F4H) 
7 6 2 4 3 2 1 0 


Bit R/W_ Description 
7 R REQUEST FOR MASTER 
0 = Data register not ready 
1 = Data register is ready to be read or written by processor 
6 R DATA I/O DIR - Data I/O Direction 
) = Transfer data from processor to data register 
1 = Transfer data from data register to processor 
5 R NON-DMA MODE 
Q = Result phase (execution phase ended} 
1 = Execution phase 
4 R CONTROL BUSY 
0 = Controller ready to accept new command 
1 = Controller processing a read or write command 
3 R DRIVE 3 BUSY 
0 = Drive 3 not seeking 
1 = Drive 3 seeking new track 
2 R DRIVE 2 BUSY 
Q = Drive 2 not seeking 
1 = Drive 2 seeking new track 
1 R DRIVE 1 BUSY 
0 = Drive 1 not seeking 
1 = Drive 1 seeking new track 
0 R DRIVE 0 BUSY 
Q = Drive 0 not seeking 
_= Drive 0 seeking new track 
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Data Register (O3F5H) 
7 6 5 4 3 2 1 0 
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STATUS OR DATA 


SS EO: LEO ARE, LATOR SEER ON: eT (CN ee eMC ee et 


Bit R/W_ Description 
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7-0 R/W_ Status or data 


eee eP Rm aonnsd een HAIMA ONEN sinnerman eet Oe tierOueiietnrnceneenSOetntomtan misnomer mia eine eyes onmmeanetn ie eannoonanmmetoneteneMIN 


se pines ims ines Sanit iene asinine Nee eA PRATER hii WP ae tetas UNH AenptoreerteRO NID 


This register accesses several internal diskette drive controller registers. The 
internal register accessed depends on the state of the diskette drive controller. 
The internal registers and the diskette drive controller states are discussed 
later in this chapter in the section Diskette Drive Controller Programming. 
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Data Transfer Rate Register (O3F6H) 
7 6 5 4 5 2 1 0 


TRANSFER RATE 


nlm URAC et Lee reece 


Bit R/W_ Description 
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7-2 W Always 0 


1-0 W TRANSFER RATE 
00 = 500 KBits per second 
01 = 250 KBits per second * 
10 = 250 KBits per second 
11 = Not used (selects 250 KBits per second) 
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* The industry-standard transfer rate for the bit values (01) is 300 KBits 
per second. 


On power-up, this register defaults to 250 KBits per second. 


Change Register (03F6H) 
7 6 5 4 3 2 1 0 


CHANGE 
STATUS 


7 R CHANGE STATUS 
QO = Since the last time this register was read, the diskette in the 
selected drive has not been removed. 
1 = Since the last time this register was read, the diskette in the 


selected drive was removed. 
6-0 R Always 0 
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Diskette Drive Controller Internal Registers 


The diskette drive controller has several internal registers that are read or 
written through the data register as a series of command or status bytes. The 
usage of these registers is dependent on the command. Tables 11-3 through 
11-17 define the command specific usage. 


Internal Register - Command 


7 6 2 4 3 Z 1 0 
Saree eais | sai Giclee’ Ganeleaakie ‘uaa + 


COMMAND SELECT 
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Bits R/W_ Description 
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7 WwW MT - Multi-track (Must be 0 for some commands) 
Q = Disable multi-track 
| = Enable multi-track (Accessing both sides of the diskette 


automatically) 


6 W MFM - Modified Frequency Modulation 
Q = Use FM (Frequency Modulation) for reading and writing the 
diskette 
1 = Use MFM for reading and writing the diskette 


5 W SK - Skip (Must be 0 for some commands) 
0 = Do not skip sectors containing a DELETED DATA 
ADDRESS MARK 
1 = Skip sectors containing a DELETED DATA ADDRESS 
MARK 


4-0 W COMMAND SELECT 
00010 = Read Track 01010 = Read ID 
00011 = Specify 01100 = Read Deleted Data 
00100 = Sense Drive Status 01101 = Format Track 
OO0101 = Write Data 01111 = Seek 
O0O110 = Read Data 10001 = Scan Equal 
OO1L11 = Recalibrate 11001 = Scan Low or Equal 
01000 = Sense Interrupt Status 11101 = Scan High or Equal 
01001 = Write Deleted Data 
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Internal Register - Head/Unit Select 
7 6 5 4 3 2 1 0 


ne tse et 


Bit R/W_ Description 
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7-3 WwW Always 0 


2 WwW HEAD SELECT 
Q = Select head on side 0 
1 = Select head on side 1 


1-0 WwW UNIT SELECT 
00 = Select drive 0 
01 = Select drive 1 
10 = Select drive 2 
Li Select drive 3 


I 


Because the outputs are not connected, these bits are ineffective. 
Use bits 5, 4, and 0 of the control register to select the drive. 
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Internal Register - Status Register 0 
7 6 5 4 3 2 1 0 
Beaeciete Seer tonne rene ha aa ee ee 
INTERRUPT | SEEK 
CODE END 
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Bit R/W_ Description 
7-6 RR INTERRUPT CODE 
00 = Command completed successfully 
01 = Command started but did not complete successfully 
10 = Command was never started 
11 = Abnormal termination (disk drive ready signal changed 
state during command execution) 


5 R SEEK END 
0 = Seek not complete 
1 = Seek complete 


4 R EC - Equipment Check 
0 = No error detected 
1 = Fault signal detected or, during a recalibrate, the track 0 
signal was not detected after 77 step pulses 
3 R NOT READY 
Q = Drive was ready 
_= Drive not ready signal was detected 
2 R HEAD ADDRESS 
0 = Side 0 selected 
1 = Side 1 selected 
1-0 R UNIT SELECT 
00 = Drive 0 selected 
01 = Drive 1 selected 
10 = __— Drive 2 selected 
11 = Drive 3 selected 
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Internal Register - Status Register | 
7 6 5 4 3 2 z 0 
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Bit R/W_ Description 
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q R EN - End of Cylinder 
Q = No error 
1 = Controller attempted to access a sector beyond the last 
sector of a cylinder 


6 R Always 0 
5 R. DATA ERROR 


0 = No error 
1 = Controller detected a cyclic redundancy check (CRC) error in 
the ID or data field 


4 R OVERRUN 
Q = No error 
1 = During a data transfer in non-DMA mode, the processor did 
not service the controller within the required time interval 
3 R Always 0 
2 R NO DATA 
Q = No error 
1 = One of the following conditions occurred: 
During execution of a read data, a write-deleted data, or a scan 
command, the controller could not find the specified sector. 
During execution of a read ID command, the controller could not 
read the ID field. 
During execution of a read track command, the starting sector 
could not be found. 
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Bit R/W Description (Status Reet 1 - cont.) 
1 R NW - Not Writable 
Q = No error 
1 = During a write data, write-deleted data, or format track com- 
mand, the controller detected a write-protect. signal from the 
disk drive. 
0 R MISSING ADDRESS MARK 
0 = No error 
1 = One of the following conditions occurred: 


The controller had detected the index hole twice, but had not 
detected the ID field ADDRESS MARK. 


The controller could not detect the DATA ADDRESS MARK 
or the DELETED DATA ADDRESS MARK. When this bit 
is set, status register 2 bit 0 (MD) is set. 
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Internal Register - Status Register 2 
7 6 5 4 3 Z 1 0 


Bit R/W wescupaon 
7 R Always 0 


R CONTROL MARK 
0 = DELETED DATA ADDRESS MARK not detected 
1 = During a read data or scan command, the controller found a 
DELETED DATA ADDRESS MARK. 


5 R DATA ERROR IN DATA FIELD 
Q = No error 
1 = Controller detected a cyclic redundancy check (CRC) error in 
the data field. 


4 R WC - Wrong Cylinder 
Q = No error 
1 = Cylinder number in the ID field does not match the cylinder 
number in the internal register 


0 - “No O raaten. 
1 = During the execution of a scan command, the equal condition 
was Satisfied. 


2 R SN - Scan Not Satisfied 
Q = No error 
During the execution of a scan command, the controller 
could not find a sector on the cylinder that met the 
condition. 


1 R BC - Bad Cylinder 
Q = No error 
= Cylinder number in the ID field is FFH and does not match 
he cylinder number in the internal register 


0 R MD - Missing ADDRESS MARK in Data Field 
Q = No error 
= During execution of a read command, the controller could 
not find a DATA ADDRESS MARK or DELETED DATA 
ADDRESS MARK. 
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Internal Register - Status Register 3 


7 6 a 4 o 2 1 0 


UNIT SELECT 
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Q = No error 
1 = Diskette drive fault signal detected 


6 R WRITE PROTECT 
Q = Diskette not write protected 
1 = Diskette drive write protect signal detected 


5 R READY 
0 = Drive not ready 
= Drive ready 


Q = Read/Write heads not over track 0 
1 = Read/Write heads over track 0 
3 R TWO SIDE 
0 = Diskette is single sided 
1 = Diskette is double sided 


2 R HEAD ADDRESS 
0 = Side 0 selected 
1 = Side 1 selected 


1-0 R UNIT SELECT 
00 = Drive 0 selected 
01 =  #£zDrive 1 selected 
10 = __—sOD rive 2 selected 
ll = Drive 3 selected 
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Internal Register - SRT/HUT 


F 


Bit 


3-0 


snes ieee mene tne nena bona ideo een tenner 


11-14 


Ww 


6 


> 


SRT 


SRT - St 
0000 = 

0001 = 
0010 = 
0011 = 
0100 = 
0101 = 
0110 = 
0111 = 


HUT 
0000 
0001 = 
0010 = 
0011 = 
0100 = 
0101 = 
0110 = 
0111 = 


i 


] 


aK 


tinier ein 


R/W_ Description 


erie se tildamearensoon atone 


Ww 


EE TE Tn eee 


pee ear Mat Scere 


ep Rate 


16 ms 
15 ms 
14 ms 
13 ms 
12 ms 
ll ms 
10 ms 
9 ms 


() 
16 ms 
32 ms 
48 ms 
64 ms 
80 ms 
96 ms 


112 ms 


sien 


4 3 


1000 = 
1001. = 
1010 = 
1011 = 
1100 = 
L110 
llll = 


- Head Unload Time 


1000 = 
1001. = 
1010 = 
1011 = 
1100 = 
1102 = 
LLG = 
Li. = 


1 ms 


128 ms 
144 ms 
160 ms 
176 ms 
192 ms 
208 ms 
224 ms 
240 ms 


ie 
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Internal Register - HLT/ND 


7 6 e 4 3 2 1 0 
a 


HLT | ND 


SRR e ee! Se ee Lee aL! Mee Se TE, ee See! /Meaee meee sey. = 


Bit R/W_ Description 
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7-1 W HLT - Head Load Time 
0000000 = No head load time 
QOOOOOOL-LL11111 = 2 ms to 254 ms in 2 ms steps 

0) W ND - Non-DMA Mode 
QO = DMA mode enabled 
| = DMA mode disabled 


pretest steepest SANNA  NI eta swoon eserves einai one inn 


eet oman een enmity elites 


Internal Register - C 


ensure that it is at the correct cylinder/track, the diskette controller compares 
this cylinder/track number to the cylinder/track in the sector header. 


Internal Register - H 


This 8-bit register specifies the currently selected read/write head. To ensure 
that it is on the correct side of the diskette, the diskette controller compares 


this head address to the head address in the sector header. Only 0 and 1 are 
valid values. 


Internal Register - R 


This 8-bit register specifies the desired sector number. 


ol 
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Internal Register - N 


This 8-bit register specifies the number of data bytes per sector as follows: 


Value Bytes per Sector 


mn nacaattninnenenedntscnnusseutsiinincnatininc oper _senfonntreeemettoeeeermsce nessa ietnehctee MORIN EPR ICED HNMR iii iseeainnt seen 5: Sonnet er ett eee eed 


OOH 128 
O1H 256 
02H 512 
03H 102: 
04H 2048 
05H 4096 
06H S192 


ttt nseumenenecneeenetnsee UMD eens NNINENalepsON AWARDS Pie hae tin enone IANO Oradea iin barclays netted ewonenniiate tO 


Internal Register - EOT 


This 8-bit register specifies the last sector of a read/write operation. The value 
written to this register is the last desired sector plus 1. 


For example, to read or write one sector (sector number 5), internal register R 
would contain 05H and internal register EOT would contain 06H. To read or 


write five sectors (starting at sector 1), internal register R would contain 01H 
and internal register EOT would contain 06H. 


This 8-bit register specifies the gap between sectors. When executing the 
format-track command, use a value of 54H, Otherwise, use a value of 1BH. 
These are the values specified by the ROM BIOS. See Interrupt 13H in 


Chapter 15. 


Internal Register - DTL 

When internal register N contains 00H, this 8-bit register specifies the number 
of bytes to be read from or written into a sector. For this register, the ROM 
BIOS defines a value of FFH. See Interrupt 13H in Chapter 15. 

Internal Register - SC 


For the format-track command, this 8-bit register specifies the number sectors 
per track, 
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Internal Register - D 

east For the format-track command, this 8-bit register specifies the value used as a 
fill byte. For this register, the ROM BIOS defines a value of F6H. See 
Interrupt 13H in Chapter 15. 
Internal Register - STP 
For the scan commands, this register specifies contiguous sectors (interleave of 
1) or alternate sectors (interleave of 2). 
Internal Register - PCN 
For the sense-interrupt-status command, this 8-bit register returns the result- 
ing present-cylinder number 
Internal Registers - NCN 


For the seek command, this 8-bit register specifies the desired cylinder/track 
number (new cylinder number). 


“Wiisaiagill™ 
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Diskette Drive Controller Programming 


The diskette drive controller has three operational states, command, execution, 
and result. The current state is determined by bit 7 (REQUEST FOR 
MASTER) and bit 6 (I/O DIR) of the main status register. If bit 7 is equal to 
0, the diskette drive controller is in the execution state. Otherwise, the diskette 
drive controller is in a command or result state. Bit 6 determines whether the 
diskette drive controller is in the command or result state. If bit 6 is equal to 
0, the diskette drive controller is in the command state. Otherwise, the 
diskette drive controller is in the result state. 


Command State 


The diskette drive controller accepts a series of 1 to 9 command bytes that are 
written to the data register. Each command has a fixed set of data bytes that 
are required to initiate the command. For correct results, the set must not be 
shortened. 


On acceptance of a command, the diskette drive controller enters the execution 
state. If a command is not accepted as a valid command, the diskette drive 
controller sets the internal register, status register 0, equal to 80H. 


The diskette drive controller has fifteen commands. Table 11-2 eae the 
diskette drive controller commands. The commands listed in Table 11-2 are 
described later in this chapter. The four internal status registers, = are 
described in the section on Diskette Drive Controller Internal Registers. 
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Table 11-2: Diskette Drive Controller Commands 


iio nmoornanonnnsintnminenarnrcirnha 


ronment ummm tnenisnyns mnie ann sienna en nate nhainainietrs ender settee annie 


Read Data 
Write Data 


Read Deleted Data 


Write Deleted Data 


Read Track 


Read ID 


Format Track 
Scan Equal 
Scan Low or Equal 


Scan High or Equal 


Recalibrate 


Sense Interrupt Status 


Specify 
Sense Drive Status 


Seek 


estraaae ivoire seins vows 


ono 
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Description 


roti sec 


mnannmnnnsesaanyontagietneiesainieigpamanninewnentenii 


Multi-sector read of sectors with DA’ TA ADDRESS 
MARK in header (at the current track) 


Multi-sector write at the current track (writes a 
DATA ADDRESS MARK in header) 


Multi-sector read at the current track (including those 
with a DE LETE D DATA ADDRESS MARK in 
header) 


Multi-sector write at the current track (writes a 


DELETED DATA ADDRESS MARK) 
Read all sectors at the current track 


Reads the ID field of the first sector encountered at 
the current track 


Formats sectors in the track as indicated 


Data on the diskette is compared for equality to data 
in memory (8-bit data) 


Data on the diskette is compared for equality or a 
value less than the data in memory (8-bit data) 


Data on the diskette is compared for equality or a 
value greater than the data in memory (8-bit data) 


Read/Write heads retract to track 0 
Returns the internally stored status registers 


Sets the diskette controller parameters HEAD LOAD, 
HEAD UNLOAD, and STEP RATE 

Loads the current drive status into the internal regis- 
ter, status register 3 


Read/Write heads move to the specified track 
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Execution State 

The diskette drive controller executes the command as instructed. When the 
operation is complete, the diskette drive controller generates an interrupt to 
the processor and enters the result state. 


NOTE 

The seek and recalibrate commands do not have a result state. 
The overlapped seek or recalibration capability, described in the 
following explanation, is not supported by vAXmate diskette 
drive controllers or industry-standard diskette drive controllers. 
The floppy disk controller chip supports overlapped seeks and 


recalibrations. That is, issuing a seek or recalibrate command to 
wees or more oe se ses nace sas or reca librate com- 
was sinadiated: After ts suing « one or more see ek or rec: alibuate: 
commands, the controlling program must monitor the main 
status register. Bits 3-0 of the main status register reflect the 
status of the corresponding drive. 


Result State 


On completion of a command, the diskette drive controller provides a series of 
status bytes that are read from the data register. These status bytes represent 
the states of corresponding internal registers. Each command has a fixed set of 
status bytes that result from a command. Until all of the status bytes have 
been read, the diskette drive controller will not accept a new command. 


Command and Result Register Sets 


Each command has a specific set of internal registers that must be written 
through the data register. During the result state, each command has a specific 
set of internal registers that must be read through the data register. 

Tables 11-3 through 11-17 define the command and result register sets for the 
various commands. 


Invalid command codes produce a result state that contains only status register 
3. 
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Table 11-3. Register Sets for Read Data Command 


eee State Order Register Comment 


“ait princeton anamnestic 
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Command 1 Command 
2 Head/Unit Select 
. é Cylinder 
4 H Head address 
5 R Sector number 
6 N Sector Size 
7 EOT Last sector for operation 
8 GPL Gap length 
9 Dri Data Length 
Status Register 0 
Status Register 1 
Status Register 2 


Result 


> Cylinder 

H Head address 
R Sector number 
N Sector Size 


roan ities monensin i vomit soto ott i ie esprticeasintediaronnng tmnt onic ti nent ainsi aetna te reteset naman 


oe ON 
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Table 11-4 Register Sets for Write Data Command 


Me a 
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State Order Register Comment 


Command 1 Command SK must be 0 

2 Head/Unit Select 

3 © Cylinder 

4 H Head address 

5 R Sector number 

6 N Sector Size 

7 EOT Last sector for operation 
8 GPL Gap length 

DTL Data Length 


Status Register 0 

Status Register 1 

Status Register 2 

% Cylinder 

H Head address 
R Sector number 
N Sector Size 


inners apc in eine Mon i ees eee inners avn ieee eee remot peerings 


Result 


WDA BwNe 
— 
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Table 11-5 Register Sets for Read Deleted Data Command 


_ Sonos nhtesionsnereni sic inant toner negro ienemmoaoneNtneMermeerre 


State Order Register Comment 
Sommand 1 Command 
2 Head/Unit Select 
3 C Cylinder 
4 H Head address 
3) R Sector number 
6 N Sector Size 
7 EOT Last sector for operation 
8 GPL aap length 
DTL Data Length 


Status Register 0 

Status Register | 

Status Register 2 

C Cylinder 

H Head address 
R Sector number 
N Sector Size 


sinc iin anata tan tmp anni biiinnintoonmi eea anor siento snes op nininmrasomanaynaen DUA ctnesoiacnnlti ose yn semen as inners mmoemnlepanKOneolerntereDHN 
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reinsert 
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Result 


AST RwNe 


Table 11-6 Register Sets for Write Deleted Data Command 


_eonynisnamentntanrataenrninenan 


State Order Register Comment 


ssn aston enone naa 
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Command 1 Command SK must be 0 
2 Head/Unit Select 
3 C Jylinder 
4 H Head address 
D R Sector number 
6 N Sector Size 
7 EOT Last sector for operation 
8 GPL Gap length 
g DTL Data Length 


Result 1 Status Register 0 

2 Status Register 1 
‘ Status Register 2 
C Cylinder 
H Head address 
R Sector number 
N Sector Size 
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Table 11-7 Register Sets for Read Track Command 


menses osnmmerneee “raat 


“an” State Order Register Comment 
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isi 


Command ] Command MT must be 0 
2 Head/Unit Select 
¢ C Cylinder 
4 H Head address 
5 R Sector number 
6 N Sector Size 
7 EOT Last sector for operation 
8 GPL asap length 
9 DTL Data Length 


Result | Status Register 0 

2 Status Register 1 

3 Status Register 2 

4 C Cylinder 

5 H Head address 

6 R Sector number 
N Sector Size 
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Table 11-8 Register Sets for Read ID Command 
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State Order Register Comment 
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Command 1 Command MT and SK must be 0 
2 Head/Unit Select 


Result | Status Register 0 
2 Status Register 1 
3 Status Register 2 
4 C Cylinder 
S H Head address 
6 R Sector number 
7 N Sector Size 
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Table 11-9 Register Sets for Format Track Command 


‘nase 


State Order Register Comment 


onset eee tense aan OUND MRNAS nai retain eMiniin RNasnan insincere Oe Ht 7 mee NNER SSN 


Command 1 Command MT and SK must be 0 
2 Head/Unit Select 
3 N Sector Size 
4 SC Sectors per track 
GPL Gap length 
D Fill data 


ee 
ee 


nd 


Status Register | 

Status Register 2 

C Cylinder 

H Head address 
Sector number 
Sector Size 
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Result 
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Table 11-10 Register Sets for Scan Equal Command 


State Order Register Comment 


1 Sommand 

c Head/Unit Select 

C Cylinder 

H Head address 

R Sector number 

N Sector Size 

EOT Last sector for operation 
GPL Gap length 

STP Interleave (1 or 2} 


Status Register 0 

Status Register 1 

Status Register 2 

C Cylinder 

H Head address 
R Sector number 
N Sector Size 
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Command 


doe GO 


= 


Tole ue 


Result 


WHAM 


11-24 Diskette Drive Controller - Hardware Description 


Table 11-11 Register Sets for Scan Low or Equal Command 


seen 


State Order 
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Command 1 
3 
4 
5 
6 


Result ] 
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Register 


Command 
Head/Unit Select 
C 

H 

R 

N 

EOT 

GPL 

STP 


Status Register 0 
Status Register | 
Status Register 2 
C 


nenivadnerorceetmuetieineteavenvnmenonsoenaivinOnnenranentnasnnnnetn 


Comment 


ntact hides Mi emesis eens annotate i inns einen inte ens 


Cylinder 

Head address 

Sector number 

Sector Size 

Last sector for operation 
Gap length 

Interleave (1 or 2) 


Cylinder 

Head address 
Sector number 
Sector Size 
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Table 11-12 Register Sets for Scan High or Equal Command 


Command 1 


Result ] 
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Command 
Head/ Unit Select 


H 
R 
N 
BOT 
GPL 
STP 


Status Register 0 
Status Register 1 
Status Register 2 
6. 


ons sstasonntormmynniiinetuinassntenreroniyn oneness meester nmi 
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Cylinder 

Head address 

Sector number 

Sector Size 

Last sector for operation 
Gap length 

Interleave (1 or 2) 


Cylinder 

Head address 
Sector number 
Sector Size 
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Table 11-13 seceaatdl eile for Recalibrate Command 
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State Gier Register Comment 


isin nine mee emt ineaeenomar one NaAoeF ERR GAG OHSS nai oN A tema 
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Command 4 Coun etn 
ie Head/Unit Select 
Result None Issue a sense interrupt 
status command 
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Table 11-14 Register Sets for Sense Interrupt Status Command 
£ p 
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State Order Register Comment 
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Command 1 Command 
9 Head/Unit Select 


Result 1 Status Register 0 
2 PCN Present Seto sauteed 
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State Order Register Comment 


Command ] Command 
2 SRT/HUT 
3 HLT/ND 
Result None Command does not have a 
result state 
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Table 11-16 mee leet Sets for ener Drive eased Command 


State Gract _ Register Connie: 


Command ] C omma ‘ail 
ys Head/Unit Select 


Result Status Register 3 
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Table 11-17 Register Sets for ano Command 


State Order Rspiater Chnaeak: 


1 Command 
2 Head/Unit Select 
3 NCN New cylinder number 


Command 


Result None Issue a sense interrupt 
status command 
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Programming Example 
The following programming example demonstrates: 


Initializing the diskette drive controller 
Using DMA data transfers 
Recalibrating the diskette drive 
Seeking to a track 

Hard formatting a diskette 


* *« © @ @ 


CAUTION 

Improper programming’ or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 
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cece 


#include "kyb.h" 
#include "example.h" 


JCI OCI ICI I IO OIRO ICICI I ICICI IC ICH a a i 2k ak ack ak akc ae ake ake ak a kak ok ac ake ak ak ae ake ok ke eo ak: / 


/* define constants used in diskette controller example 


* ff 


JOO ICG ICO IG A AOR IO IC Gk ok oI SG CIC oe ake kc 2k kok a ae a ae akc aks ofa ake oe ake ak fe a fee ake fe keke ate ake ake ake // 


/* define bit values for diskette controller control register (DCCR) 
#define DRV_SEL OxO0l /* bit mask for drive select 
#define FDC_ON 0x04 /* bit value allows fdce to run 


if this bit not set, fdc is reset 
#define DMA_INT_ON Ox08 /* value to enable DMA and interrupts to CPU 


#define DRVA_MOTOR 0x10 /* bit value to turn on drive a motor 
#define DRVB_MOTOR 0x20 /* bit value to turn on drive b motor 


/* define bit values for data transfer rate register */ 


#define DTR_500 0x00 /* bit value for 500 Kbit transfer rate 
#define DTR_300 Ox01 /* VAXmate = 250 Kbit transfer rate 
#define DTR_250 0x10 /* bit value for 250 Kbit transfer rate 


/* define disk change register bit */ 
#define DISK_CHG 0x80 /* diskette changed if set 


/* define bit values for FDC main status register */ 


+f 
*/ 


*/ 
*/ 
/ 
*/ 


#define FDDO_BUSY 0x01 /* diskette drive O busy doing seek */ 
#define FDD1_BUSY 0x02 /* diskette drive 1 busy doing seek */ 
#define FDD2_BUSY 0x04 /* diskette drive 2 busy doing seek */ 
#define FDD3_BUSY 0x08 /* diskette drive 3 busy doing seek */ 
#define FDD_BUSY FDDO_BUSY | FDD1_BUSY | FDD2_BUSY | FDD3_BUSY 

#define FDC_CB 0x10 /* controller busy */ 
#define FDC_NDM 0x20 /* in non-DMA mode = execution phase busy */ 
#define DIO_RD 0x40 /* indicates processor should read data reg */ 
#define RQM 0x80 /* data register ready to send or receive */ 
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/* define status register 0 bit values */ 


#define SRO_USO 0x00 /* at interrupt time, unit select = drive 
#define SRO_US1 0x01 /* at interrupt time, unit select = drive 
#define SRO_US2 0x02 /* at interrupt time, unit select drive 
#define SRO_US3 0x03 /* at interrupt time, unit select = drive 


ll 


Whe © 


#define SRO_HD 0x04 /* head address at interrupt time */ 
#define SRO_NR 0x08 /* diskette drive not ready * 
#define SRO_EC 0x10 /* equipment check, could not reach track O * 
#define SRO_SE 0x20 /* seek command completed * 
#define SRO_IC_AT 0x40 /* interrupt code = abnormal termination * 
#define SRO_IC_IC 0x80 /* interrupt code = invalid command */ 


#define SRO_IC_NR OxcO /* interrupt code = drive not ready * 


#define SRO_IC_NT 0x00 /* interrupt code = normal termination */ 


/* define status register 1 bit values */ 


#define SR1_MA 0x01 /* missing address mark > 


#define SR1_NW 0x02 /* write protect signal detected * 
#define SRi_ND 0x04 /* couldn’t find sector, or couldn’t read ID */ 
#define SR1i_OR 0x10 /* did not receive data in time */ 
#define SR1i_DE 0x20 /* data field or ID field CRC error * 


a #define SR1_EN 0x80 /* tried to access sector at end of cylinder 


/* define status register 2 bit values */ 


#define SR2_MD 0x01 /* missing address mark in data field * 


sone: 


#define SR2_BC 0x02 /* bad cylinder * 


#define SR2_SN 0x04 /* scan command could not find a sector * 
#define SR2_SH 0x08 /* scan equal hit * 


#define SR2_WC 0x10 /* wrong cylinder * 
#define SR2_DD 0x20 /* CRC error in data field * 


#define SR2_CM 0x40 /* deleted data address mark found * 
/* define status register 3 bit values */ 


#define SR3_USO 0x00 /* unit select - drive 
#define SR3_US1 Ox01 /* unit select - drive 


0 

1 *, 
#define SR3_US2 0x02 /* unit select - drive 2 »* 
#define SR3_US3 0x03 /* unit select - drive 3 


#define SR3_HD 0x04 /* head address */ 


#define SR3_TO 0x10 /* drive signal - track 0 + 


#define SR3_TS 0x08 /* drive signal - two side * 


#define SRS_RDY 0x20 /* drive signal ~- ready * 
#define SR3_WP 0x40 /* drive signal ~ write protect */ 


#define SR3_FT 0x80 /* drive signal - FAULT */ 


ae 
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/* define base values of fdc commands */ 


#define 
#define 
#define 
#define 


#define | 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
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/* define some general constants 


FDCG_RD 
FDC_RDD 
FDC_WD 


FDC_ID 
FDC_FT 
FDC_SE 
FDC_SLE 
FDC_SHE 
FDC_RECAL 
FDC_SIS 
FDC_SPE 
FDC_SDS 
FDC_SEEK 
FDC_MT 
FDC_MFM 
FDC_SK 


0x06 
0xOc 
0x05 
0x09 
0x02 
Ox0a 
0x0d 
Ox11 
0x19 
Oxid 
0x07 
0x08 
0x03 
0x04 
OxO0f 
0x80 
0x40 
0x20 


ri ok 


/* read data 
/* read deleted data 
/* write data 
/* write deleted data 


/* read 


track 


/* xead ID 


format 
/* scan 


/* scan low or 

/* scan high or 

/* recalibrate drive 
/* sense interrupt status 
/* specify 
/* sense drive status 
/* seek 
/* multi-track 
/* modified frequency modulation 
/* skip deleted data address mark 


track 
equal 
equal 
equal 


*/ 
* [ 
xf 
* f 
af 
& f 
at / 
 f 
at 
* / 
x f 
of 
+ / 
* / 
+ / 
+f 
J 
*/ 


x f 
* f 


[*** she ok oie oe ple oe oh ie oe oe oe oie ok ok os okt oc ofe ok oe oie oe oe oe ke ote ok ok of ofc oe oe oe ole he pk ole ie oe phe oe ois oh oe ode oh oe of ole ok of oie oe ole ate ote ok oe okt oe ok ae ake ok oe ok ek f 


#define RETRY_COUNT 4 


/* maximum retries */ 


JOO OR OOOO IG OIC OOK IO dor OGG OG GR ICCC desk oka ake ake ake ok ac dea ak ake / 


/* define some error codes 
[ROOK OOO I IOI IOI IO SO koko kok kodak desk ak kokodk de ak ak ak ak ak ke ak ake / 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
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ERR_FATAL 


ERR_FAT_WR 


ERR_TO 
ERR_DNR 


ERR_SEEK 


Oxffiff 
Oxfffe 
Oxfffd 
Oxfffc 
Oxfffb 
0x0001 
0x0002 


/* fatal error of 
/* fdc was expecting 
/* fdc was expecting 


/* 
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unknown origin 
write not read 
read not 
time out 

/* drive not 
/* recalibrate 


/* seek 


write 
error 
ready 
error 
error 


* f 


+ / 
* ff 
* | 
* / 
+f 
+f 
* | 


NG i 
"iio ait 


JORG ROI OI tok sk akokookok oR dk ok koko uk kak sk ake oka a aie ok ak ake akc ake ake ak aco / 


/* declare structures used in diskette controller example 
{RIO Ook oo ok dod kk dk kd Gok ok kok kok ak ak ake ak ake ak akc sk ke ake akc kt oke fe og ok ake oc ake ade ote ake ke / 


| 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


} FDC; 


#define FDC_BASE (FDC *)0x03F2 


typedef struct 


char 
char 
char 
char 
char 
char 


typedef struct 


{ 
unsigned 
unsigned 
unsigned 
unsigned 
int busy; 


char 
char 
char 
char 


int retry; 


unsigned 
unsigned 
int hsd; 
int msd; 
int mod; 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
} FDC_CMD; 


char 
char 


*/ 


dccr; /* diskette controller control register */ 
reservedi; /* I/O space not used by controller */ 
fdc_stat; /* diskette controller main status register */ 
fdc_data: /* diskette controller data register * f 
reserved2; /* I/O space not used by controller */ 
gtr /* read <----~-- diskette change register */ 
/* write ~--> data transfer rate register */ 

/* base address of FDC structure */ 


mt ; 

mfm; 

sk; 

last_cmd; /* 


daecr: 
dtr; 
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/* multi-track * 
/* mfim/fm > 
/* skip + 


last command sent to fdc 


/* busy flag * 

/* retry count - 

/* dccr contents * 

/* data transfer rate ° 
/* head setitle delay » 

/* motor start up delay -: 


/* motor off delay 


/* drive select 0 - 3 * 
/* cylinder number * 


/* head side 


/* gector number + 


/* bytes per sectors 


/* end of track : 
/* sector gap length - 
/* format gap length 


/* sector count 


/* format fill byte » 
/* data length * 
flag * 


/* scan skip sector 
/* step rate 

/* head load 

/* head unload 

/* non-DMA 


time 


1] - 


time + 
time * 
mode * 


31 


unsigned 
unsigned 
unsigned 
unsigned 
int hsd; 
int msd; 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


} FDD; 


typedef st 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


- 32 Diskette Drive ( 


typedef struct 


char 
char 
char 
char 


ruct 


char 
char 
char 
char 
char 
char 
char 


char n: 


char 
int 


char change; 
} FDC_RESULT ; 


/* multi-track 

/* mfim/fm 

/* skip 

/* data transfer rate 
/* head settle delay 
/* motor start up delay 
/* cylinder number 

/* head side 

/* gector number 

/* bytes per sectors 
/* end of track 

/* sector gap length 
/* format gap length 
/* sector count 

/* data length 

/* step rate time 

/* head load time 

/* head unload time 


/* status register 0 

/* status register 1 

/* status register 2 

/* status register 3 

/* cylinder number 

/* head side 

/* sector number 

/* bytes per sectors 

/* present cylinder number 
/* error code/status 

/* diskette change register. 
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Jf tk i ke dk ok kkk she she ole she ote oe ok de she ok ok ok SIC GG kok koko kk I I IG ICIC Cf oft ok ac eft ok ak ak ake aka akc ake ake ade ake / 
/* declare some external timers * / 
JRO CIO OOK A ROO GIGI GIGIG GOO Gk kkk kok ak ke sk ke doi ke ok ok ok ie ak ake ok ok ak ok / 


extern int head_settle; /* head settle and motor startup timer */ 
extern int motor_flag; /* automatic motor shut off timer */ 
/ geeks oe vic okt hs ois oft okt cfs che ole he she ote oe he ce ae oe ke ae he he oe oe ote ode ke ob othe ate he whe ole he ke he le oe ole he ok oe the ofc ok fe she fe ofc obs oft ofa ode obs oh ake ofe ake oft ste ke fe ofc she nhc ode ode ode ote / 
/* declare space for fdc parameter data * / 


[DOOR CIO OC GOI IG iG a kkk a oa ao CII IK a fo dc ak ak ee ok ka ao ake ale ok ake ke ae ak ke ake aie ak ak ake // 


FDC_CMD fde_cmd = 

{ 
0x00, /* not multi-track to start */ 
FDC_MFM, /* always mfm */ 
0x00, /* not skipping */ 
0x00, /* no last command yet */ 
FALSE, /* not busy yet */ 
0x00, /* current retries */ 
0x00, /* nothing enabled until fde is reset */ 
DTR_500, /* data transfer rate is 500 Kbits */ 
a /* 3.90625 ms * 5 = 19.5312 ms = head settle delay */ 
128, /* 3.90625 ms * 128 = 500 ms motor startup delay */ 
512, /* 3.90625 ms * 512 = 2 seconds motor off delay */ 
0x00, /* no drive selected */ 
0x00, /* cylinder 0 to start */ 
0x00, /* head zero to start */ 
Ox01, /* sector 1 to start */ 
0x02, /* 512 bytes per sectors */ 
0x10, /* end of track at sector 16 */ 
Oxib, /* sector gap length */ 
0x54, /* format gap length */ 
OxOf, /* 15 sectors per track */ 
Oxf6, /* format fill byte */ 
Oxff, /* data length */ 
0x00, /* not skipping sectors during scan *«/ 
Ox0d, /* 3 ms step rate (1 - 16 ms in 1 ms increment) OxOf = 1 ms */ 
0x32, /* 50 ms head load time ( 0x01 = 2 ms, 0x02 =4 ms ...) */ 
0x08, /* 128 ms head unload time ( 0x01 = 16 ms, 0x02 = 32ms ...) */ 
0x00, /* select dma mode (0x00 = dma mode, Ox01 = non-dma mode) */ 

sa 


FDD fdd[2] ; /* place to store diskette parameters */ 
FDC_RESULT fdc_result ; /* place to store result and error codes */ 
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/* motor_off() - turn diskette drive motors off * | 
JOR SOR OO OR OR ok a a ok FOI kk kk a ok ok ak ok 2k ok keke ok ok kc ok oka akc ok ac ake ake ate ake oe kok ake ok ake ie ake ake // 
motor_off () 


{ 
FDC *pfdc = FDC_BASE; 
int intr_flag; /* to hold CPU IF state */ 
fdc_cmd.dccr & (DRVA_MOTOR | DRVB_MOTOR) ; /* both motors off */ 
outp(&pfdc->decr, fdce_cmd.dccr) ; /* turn them off */ 
intr_flag = int_off(); /* no interrupts please */ 
motor_flag = 0; /* clear motor timer */ 
int_on(intr_flag) ; /* allow interrupts */ 
} 
OO a OR RO kk IO IGG GG a ok a ok a ak ak ak ak ak kek ake ak ok ok Ok ok kok ak kak kok ake akc ae ke ate oe oe ak fe ae ae ake // 
/* select() - select the desired drive and turn on motor * f 
GCI OOOO OIC OCC IIRC ISIC COI IO OI OI CIC IOI IIR ICI I ICR fe ak a ak / 
select () 
it 
FDC «pfdc = FDC_BASE: 
int intr_flag; /* to hold CPU IF state */ 
if ((fdc_cmd.dccr & DRV_SEL) != fdc_cmd.ds || /* if not current */ 
(fdc_cmd.dccr & (DRVA_MOTOR | DRVB_MOTOR)) == 0)/* all motors off */ 
{ 
fdc_cmd.dccr &= DRV_SEL; /* deselect drives */ 
fdc_cmd.decr |= fdce_cmd.ds; /* select drive */ 
fdc_cmd.dccr &= (DRVA_MOTOR | DRVB_MOTOR) ; /* both motors off */ 


if ('fdc_cmd.ds) fdc_cmd.dccr |= DRVA_MOTOR; /* desired motor on */ 
else fdc_cmd.dccr |= DRVB_MOTOR; 


outp(&pfdc->dcecr, fdc_cmd.dccr) ; /* write the register */ 
intr_flag = int_offQ); /* no interrupts please */ 
motor_flag = 0; /* clear motor timer */ 
int_on(intr_flag) ; /* allow interrupts */ 
} 
if (!motor_flag) /* has motor stopped ? */ 
{ 
head_settle = fdc_cmd.msd; /* head settle timer to time start up */ 
while (head_settle) /* wait until motor is up to speed */ 
} 
intr_flag = int_off(); /* no interrupts please */ 
motor_flag = fdc_cmd.mod; /* write the motor off delay time */ 
int_on(intr_flag) ; /* allow interrupts */ 
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a hiugisl™ 


/* fdc_in() - read data from fdc data register */ 


OBR OOOO CISC SGI ISIS SCI SIC SIO SISIASSIEISISISI ICICI ACA A IAEA CIR Sak Rk ak a a ea / 


fdc_in() 

{ 

FDC *pfdc = FDC_BASE; 
int i; 


head_settle = 2; 
i = inp(&pfdc->fdc_stat) ; 
while(!(i & RQM)) 
{ 
if ('head_settle) 
{ 
fdc_result.error = ERR_TO; 
return; 
} 
else i = inp(&pfdc->fdc_stat) ; 
} 
if(i & DIO_RD) 
return(inp(&pfdc->fdc_data)) ; 
else fdc_result.error = ERR_FAT_RD; 
:: 


/« clk cycle = 3.9 ms, must read in 2 cycles */ 


/* read fdc status register */ 
/* fdc ready ? */ 


/* time out error 7? */ 


/* mark error */ 


/* read fdc status register */ 


/* data direction = cpu read ? */ 
/* return data read */ 
/* mark fatal error */ 


Diskette Drive Controller - Programming Example — 11 - 35 


(OR IO OG GO OO IGOR kk kk ICG ak ak ak ok ok kote ak ak ok a ake akc ake ok aks ake ake ak ake okt ok ke ake / 


/* fdc_out() - write data to fdc data register * f 
JRO OOO II Obi IG kkk ok Gio koko dodo dok kok ak atodode reload ae ak aca aeook / 
fdc_out (value) 


unsigned char value; /* value to write to fdc data register */ 


{ 
FDC *pfdc = FDC_BASE; 


int i; 
head_settle = 2; /* clk cycle = 3.9 ms, must read in 2 cycles */ 
i = inp(&pfdc->fdc_stat) ; /* read fdc status register */ 
while(!(i & RQM)) /* fdc ready ? */ 
{ 
if (!head_settle) /* time out error 7? */ 
{ 
fdc_result.error = ERR_TO; /* mark error */ 
return; 
} 
else i = inp (&pfdc->fdc_stat) ; /* read fdc status register * / 
} 
if((i & DIO_RD) == 0) /* data direction = cpu write ? */ 
outp(&pfdc->fdc_data, value); /* write fdc data register */ 
else fdc_result.error = ERR_FAT_WR; /* mark fatal error */ 
i 
JDC OO ICO GIG OI ok oko OR kkk ok ks doko kok dak ok dak ak desk ak ak skoak ae / 
/* waitcc() - wait for command to complete xf 


[DCO IOI IO ICI IO IOI IO OR OIC II IOI IO GI I aC dk ak a a ICR kook ak a ac ak ok ake / 


waitcc() 
{ 
while (fdc_cmd. busy) /* wait until command complete */ 
7, 
if (!motor_flag) /* time out 7 */ 
{ 
fde_result.error = ERR_TO; /* time out error */ 
return; 
} /* do something useful while waiting, like check date */ 
chk_dtQ) ; /* and time for update. ROM BIOS does an INT 15H */ 


} 
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if (fdc_result.error) return; /* error ? */ 
switch(fdc_cmd.last_cmd) /* discover last command issued */ 
{ 
case FDC_RECAL: /* recalibrate ? */ 
case FDC_SEEK: /* seek ? */ 
head_settle = fdc_cmd.hsd; /* set head settle delay timer */ 
while (head_settle) /* wait for head settle to time out */ 
fdc_cmd.last_cmd = FDC_SIS; /* get last command issued */ 
fdc_out (FDC_SIS) ; /* sense interrupt status */ 
if (fdc_result.error) return; /* error 7 */ 
fdc_result.stO = fdc_in(); /* read stO results */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.pcn = fdc_in(); /* read present cylinder number */ 
if (fdce_result.error) return; /* error ? */ 
break; 
default:/* all other commands except FDC_SPE, FDC_SIS, and FDC_SDS */ 
fdc_result.stO = fdc_in(); /* read stO results */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.sti = fdc_in(); /* read sti results */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.st2 = fdc_in(); /* read st2 results */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.c = fdc_in(); /* read cylinder results */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.h = fdc_in(); /* read head results */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.r = fdc_in(); /* read sector results */ 
if (fdc_result.error) return: /* error 7? */ 
fdc_result.n = fdc_in(); /* read bytes/sector results */ 
if (fdc_result.error) return; /* error ? */ 
break; 
} 
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/* specify() - set the diskette drive characteristics * / 


specify() 

{ 

FDC *pfdc = FDC_BASE; 

unsigned char uc; /* temporary variable */ 
outp(&pfdc->dtr, fdce_cmd.dtr) ; /* set data transfer rate */ 
outp(&pfidc->dcecr, fdc_cmd.dccr); /* set control register */ 
fdc_cmd.last_cmd = FDC_SPE; /* last command is specify */ 
fdc_out (FDC_SPE) ; /* issue specify command */ 
if (fdc_result.error) return; /* error ? */ 
uc = fdce_cmd.srt << 4; /* specify step rate */ 
uc |= fdc_cmd.hut; /* specify head unload time */ 
fdc_out (uc) ; /* issue step rate and head unload time */ 
if(fdc_result.error) return; /* error ? */ 
uc = fdc_cmd.hlt << 1; /* specify head load time */ 
uc |= fdc_cmd.nd; /* specify dma mode */ 
fdc_out (uc) ; /* issue head load time and dma mode */ 

} 
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o 


[CCI IOI GSCI GIOCHI GR GR I A a IG akc at deka / 
/* fdc_issue() - issue all fdc commands except specify and sis + 
JOR IO OCICS ICICI IC OSORIO SGI IG ok kkk sk kok ak ak ak sk kes aka de ak ae / 


fdc_issue(cmd, drv) 


int cmd; /* desired command *«/ 

int drv; /* desired drive 0 or 1 */ 

1 

FDC «pfdc = FDC_BASE; 

char oline[20]; 
fdc_cmd.ds = drv; /* indicate the drive */ 
select (drv) ; /* select appropriate drive */ 
fdc_out (FDC_SDS) ; /* sense drive status */ 
if (fdce_result.error) return; /* error ? */ 
fdc_out ((fdce_cmd.h << 2) | fdc_cmd.ds) ; /* second byte of SDS */ 
if (fdc_result.error) return; /* error ? */ 
fdc_result.st3 = fdc_in(); /* read st3 results */ 
if (fdc_result.error) return; _ /* error ? */ 


sprintf(oline, "%04x %04x", pfdc, &pfdc->dtr) ; 
disp_str(16, 1, oline); 
fdc_result.change = inp(&pfdc->dtr) & 0x80; /* read disk change reg */ 


if (fdc_result.st3 & SR3_RDY) /* drive ready ? */ 
7 
fdc_cmd.last_cmd = cmd; /* set last command issued */ 
switch (cmd) 
{ 
case FDC_SDS: 
return; 
break; 
case FDC_RECAL: /* recalibrate ? */ 
fdc_out (cmd) ; /* issue byte 1 */ 
if (fde_result.error) return; /* error ? */ 
fdc_out (fdce_cmd.ds) ; /* issue byte 2 */ 
break; 
case FDC_SEEK: /* seek ? */ 
fdc_out (cmd) ; /* issue byte 1 */ 
if (fdc_result.error) return; /* error ? */ 
fdc_out((fdc_cmd.h << 2) | fdc_cmd.ds); /* issue byte 2 */ 
if (fdc_result.error) return; /* error 7? */ 
2 


fdc_out (fde_cmd.c) ; /* issue byte 
break; 
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case FDC_ID: 


fdc_out(fdc_cmd.mfm | cmd) ; 
if (fde_result.error) return; 
fdc_out((fdc_cmd.h << 2) | 
break; 


case FDC_FT: 


fdc_out(fdc_cmd.mfm | cmd); 

if (fdc_result.error) return; 
fdc_out ((fdc_cmd.h << 2) 
if (fdc_result.error) return; 
fdc_out(fdc_cmd.n); 

if (fdc_result.error) return; 
fdc_out(fdc_cmd.sc) ; 

if (fdc_result.error) return; 
fdc_out (fdc_cmd.fgpl) ; 

if (fdc_result.error) return: 
fdc_out (fdc_cmd.d); 

if (fdc_result.error) return; 
break; 


case FDC_RD: 
case FDC_RDD: 
case FDC_WD: 
case FDC_WDD: 


11 ~ 40 


if (fdc_result.error) return; 
fdc_out((fdc_cmd.h << 2) 
if (fdc_result.error) return; 
fdc_out(fdc_cmd.c); 

if (fdc_result.error) return; 
fdc_out (fdc_cmd.h); 

if (fdc_result.error) return: 
fdc_out(fdc_cmd.r); 

if (fdc_result.error) return; 
fdc_out(fdc_cmd.n); 

if (fdc_result.error) return; 
fdc_out (fdc_cmd.eot) ; 

if (fdc_result..error) return; 
fdc_out (fdc_cmd.sgpl); 

if (fdc_result.error) return; 
fdc_out (fdce_cmd.dtl); 

break: 


fdc_cmd.ds) ; 


| fdc_cmd.ds); 


| fdc_cmd.ds); 


/* 
/* 


/* read ID 
issue byte 

/* error 
issue byte 


/* format track 


/* 
/* 


/* 


issue byte 
/* error 
issue byte 
/* error 
issue byte 
/* error 
issue byte 
/* error 
issue byte 
/* error 


* issue byte 


/* error 


/* read data 

/* read deleted data 
/* write data 

/* write deleted data 
fdc_out(fdc_cmd.mt | fdc_cmd.mfm | fdc_cmd.sk | cmd) ;/* byte 


x 
/* 
/* 
/* 


/* 
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/* error 
issue byte 
/* error 
issue byte 
/* error 
issue byte 
/* error 
issue byte 
/* error 
issue byte 
/* error 


‘ issue byte 


/* error 
issue byte 
/* error 


* issue byte 


ee ss) 


BD 


BS 


oy Oe Gio) me sy) GO 


? 


Coa An nw GAG va Toy & vy WG A NM ws 


«/ 
*/ 
“/ 
*/ 


* f 
* / 
+ / 
* / 
+f 
a 
+/ 
+ / 
+ / 
+/ 
sd 
+ / 
A 


* f 
* / 
*/ 
*/ 
*/ 
* | 
*/ 
* ff 
* f 
+ / 
x f 
* f 
* f 
* f 
* / 
* [ 
* 
* / 
/ 
*/ 
*/ 


4 er ai 


case FDC_RT: 
fdc_out(fdc_cmd.mfm | fdc_cmd.sk | cmd) 
if (fdc_result.error) return; 
fdc_out((fdc_cmd.h << 2) | fdc_cmd.ds); 
if (fdc_result.error) return; 
fdc_out (fdce_cmd.c); 
if (fdc_result.error) return: 
fdc_out(fdc_cmd.h); 
if (fdc_result.error) return; 
fdc_out(fdc_cmd.r); 
if (fdc_result.error) return; 
fdc_out(fdc_cmd.n); 
if (fdc_result..error) return; 
fdc_out (fdc_cmd.eot) ; 
if (fdc_result.error) return; 
fdc_out (fdc_cmd.sgp1) ; 
if (fdc_result.error) return: 
fdc_out(fdce_cmd.dtl); 
break; 


case FDC_SE: 
case FDC_SHE: 
case FDC_SLE: 


fdc_out(fdc_cmd.mt | fdc_cmd.mfm | fdce_cmd.sk | cmd);/* byte 


if (fdc_result.error) return; 
fdc_out((fdce_cmd.h << 2) | fdc_cmd.ds); 
if (fdc_result.error) return; 
fdc_out(fdc_cmd.c); 

if (fdc_result.error) return; 
fdc_out(fdc_cmd.h); 

if (fdc_result.error) return; 
fdc_out(fdc_cmd.r); 

if (fdc_result.error) return; 
fdc cut (ide cmd <n): 

if (fdc_result.error) return: 
fdc_out(fdc_cmd.eot); 

if (fde_result.error) return; 
fdc_out(fdc_cmd.sgp1); 

if (fde_result.error) return; 
fdc_out (fdc_cmd. stp) ; 

break; 
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/* read a track 7? */ 
, /* issue byte 1 */ 
/* error 7? */ 

/* issue byte 2 */ 
/* error 7? */ 

/* issue byte 3 */ 
/* error ? */ 

/* issue byte 4 */ 
/* error 7? */ 

/* issue byte 5 */ 
/* error ? */ 

/* issue byte 6 */ 
/* error 7? */ 

/* issue byte 7 */ 
{*® exrvor 7? #/ 

/* issue byte 8 */ 
/* error ? */ 

/* issue byte 9 */ 
/* scan equal 7? */ 
/* scan high or equal ? */ 
/* scan low or equal 7? */ 
1 */ 

/* error ? */ 

/* issue byte 2 */ 
/* error ? */ 

/* issue byte 3 */ 
/* error 7? */ 

/* issue byte 4 */ 
/* error ? */ 

/* issue byte 5 */ 
/* error 7? */ 

/* issue byte 6 */ 
/* error ? */ 

/* issue byte 7 */ 
/* error ? */ 

/* issue byte 8 */ 
/* error 7? */ 

/* issue byte 9 */ 
11- 41 


else 

4. 
fdc_result.error = ERR_DNR; /* drive not ready error */ 
return; 

} 

if (fdc_result.error) return; /* error 7? */ 

fdc_cmd.busy = TRUE; 

waitcc(); /* wait for command complete */ 


re 


disp_status(&fdc_result, &fdc_cmd) ; /* display result status */ 


} 


ROO RII IGG CGO kok ak a ak ok 2k ok ke ake ake ake ak 2k ak ok A rR aR IC Re ake oie ake aie ok ok ae a akc fe akc ake akc alee / 


/* f£dc_init() - initialize diskette controller x f 
JCC ICR IOI ICI OIG ICG Cok I iG dO a i ke deo fc ake akc ake ok ok fea ake ake ake ae ak ke de / 


fdc_init() 

{ 

FDC *pfdc = FDC_BASE; 
int intr_flag; 


intr_flag = int_off(); 
outp(&pfdc->dcecr, DMA_INT_ON) ; /* reset the fdc */ 
fdc_cmd.dccr = DMA_INT_ON | FDC_ON; /* fdc not reset */ 


outp(&pfde~>dccr, fdce_cmd.dccr) ; /* allow communications */ 
iv_init (Ox0e) ; /* initialize the interrupt vector */ 


int_on(intr_flag) ; 
imask(O, 6, 1); /* enable PIC input */ 
} 


[DOI OK Ok OO JO ICO OR OR OO IG GGG IG kok KI ack a ak kok tee / 


/* fdc_rest() - restore diskette controller and interrupt vector * 
[RR OK she she ok ofc oe oie of ole oe sie oie ole oe ok ok ie oie oie oie oe oe oie ok oie ke he oe ok oie oi 3k oe oie ee oe oe fe oh ie OE oe ote Shee ode ake okt fe oe ook oft A he fe oe oe oe eae oe ff 


fdc_rest() 
{ 
FDC *pfdc = FDC_BASE; 


outp(&pfdc->dccr, 0); /* reset the fdc */ 
imask(O, 6, 0); /* disable PIC input */ 
fdc_cmd.dccr = DMA_INT_ON | FDC_ON; /* fdc not reset */ 


outp(&pfdc->dcecr, fdc_cmd.dccr); /* allow communications */ 
iv_rest (0x0e) ; /* restore the interrupt vector */ 


/* fdc_int_hand() - fde interrupt handler + / 


[8K KK ICO OIC ICI OO IO IOI ICO I IOI ICSI IC ak sk ok ok ak ak kak ok 2k ok okt ake ak ak aie ake ake at ae ok ake ake ake ake ake ake // 


fdc_int_hand() 

{ 
fdc_cmd. busy = FALSE; /* no longer busy */ 
e0i(0); 

} 


[FORO OIG IOI OO ICA IO OR IO OI I I Ok a I I i aI a ae a ae ak 3 ak ak / 


/* fdc() - execute diskette controller examples + / 
IOI OGIO OOOO IG I kaa dak ok ack ck ake ak ak ake ae aka / 


fdc() 
{ 
static MESSAGE mfdc[] = /* fdc menu */ 


{ 

3, 27, "Diskette Controller Example" }, 
5, 27, "Fi. Turn drive A motor on" }, 
6, 27, "F2. Turn drive A motor off" }, 
7, 27, "F3. Recalibrate" }, 

8, 27, "F4. Seek track 40" }, 

9, 27, "F5. Format diskette" }, 

10, 27, "F6. Read ID" }, 


phy yp tly pi ply py pg 


12, 27, "F10. Return to Main menu" }, 

GO. 0, 0 }, 
+; 
unsigned char tmp; /* to hold CMOS byte read */ 
unsigned char sum; /* to hold calculated checksum */ 
char line[512]; /* to hold input line */ 
char oline[512]; /* to hold output line */ 
int 2; /* to hold menu selection */ 
ant. =; /* temp value */ 


FDC *pfdc = FDC_BASE; 
char *pc; 

char far *fpe = oline; 
long 1 = (long)fpc; 
long 11; 

long 12; 

int pr; 

int pa; 


#define ROW 16 
#define COL 17 
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disp_menu(mfdc) ; /* display the fdce menu */ 
li = 1 & OxOOOOffff; /* build address of buffer for DMA controller */ 
12 = 1 >> 16; 
12 <<= 4; 
l= 12 + 11; 
11 = 1 >> 16; 
pr = (int)11; /* pointer to buffer */ 
li = 1 & Oxo000offff; 
pa = (int)11; /* page register value */ 
specify(); 
line[O] = O; /* null terminated */ 
while(1) /* forever (see Fi0) */ 
{ 
disp_status(&fdc_result, &fdc_cmd) ; /* display result status */ 
line[O] = get_fkey(); /* get a function key for menu selection */ 
switch(line[0]) /* determine menu selection */ 
{ 
case Fi: /* turn drive motor on */ 
fdc_cmd.ds = 0; 
select(); 
break; 
case F2: /* turn drive motor off */ 
motor_off(); 
break; 
case F3: /* recalibrate drive */ 
select (0); 
fdc_issue(FDC_RECAL, 0); 
fdc_issue(FDC_RECAL, 0): 
fdc_issue(FDC_ID, 0); 
break; 
case F4: /* seek to track 40 */ 


select(0) ; 

fdce_cmd.c = 40; 
fdc_issue(FDC_SEEK, 0); 
fdc_issue(FDC_ID, 9); 
break; 
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case F5: /* hard format a diskette - interleave = 1 */ 


select(0); 
fdc_issue(FDC_RECAL, 0); 
fdc_issue(FDC_RECAL, 0); 
fdc_issue(FDC_ID, 0); 
for(i = 0; i < 80; itt) 
{ 
fdc_cmd.c = i; 
fdc_issue(FDC_SEEK, 0); 
fdc_cmd.h = Q; 
pe = oline; 
for(r = 1: r < 16; r++) 
{, 
*pcet++ = (char)i; 
*pct+ = '\000’; 
*pct+ = (char)r; 
epctt = *\002"; 
} 
r= (int)(1 >> 16); 
dma_transfer(2, pr, pa, 
fdc_issue(FDC_FT, 0); 
fdc_cmd.h = 1; 
pe = oline; 
for(r = 1; r < 16; rtt) 
{ 
*pet+ = (char)i; 
*kpct+ = *\OO1’; 
*pct+ = (char)r; 
kpct++ = '\002’; 
} 
r = (int)(1 >> 16); 
dma_transfer(2, pr, pa, 
fdc_issue(FDC_FT, 0); 
} 
break; 


60, 8); 


60, 8); 


/* build 


/* side 0 */ 


sector table */ 


/* setup DMA */ 


* format track */ 


/* Side 1 « / 


sector table */ 


/* setup DMA */ 


* format track */ 
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case F6: /* read any sector ID */ 
select(0) ; 
fdc_issue(FDC_RECAL, 0); 


for(i = 0; i < 80; itt) 


{ 
fdc_cmd.c = i; 
fdc_issue(FDC_SEEK, 0); 
fdc_cmd.h = QO; 
fdc_issue(FDC_ID, 0); 
fdc_cmd.h = 1; 
fdc_issue(FDC_ID, 0); 

ir 

break; 

case F10: /* return to caller (main menu) */ 


return; 


iy 
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disp_status(pres, pcmd) 


FDC_RESULT *pres; 
FDC_CMD *pcmd; 


{ 
char oline[50]: 


sprintf(oline, "Error status : 0x/04x", pres->error) ; 


disp_str(19, 1, 


oline); 


sprintf(oline, "Status reg 0 : Ox02x", pres->st0); 


disp_str(20, 1, 


oline) ; 


sprintf(oline, "Status reg 1 : Ox4Z02x", pres->st1); 


disp_str(21, 1, 


oline); 


sprintf(oline, "Status reg 2 : Ox4,02x", pres->st2) ; 


disp_str(22, 1, 


oline); 


sprintf(oline, "Status reg 3 : OxZ,02x", pres->st3) ; 


disp_str(23, 1, 


oline); 


sprintf(oline, "Present Cyl Num: 0x%02x", pres->pcn) ; 


disp_str(24, 1, 


oline) ; 


sprintf(oline, "Change reg : Ox%02x", pres~>change) ; 


disp_str(1i9, 41, 


oline); 


sprintf(oline, "Cylinder (C): Ox%02x", pres->c); 


disp_str(20, 41, 


oline); 


sprintf(oline, "Head (H):  0Ox%02x", pres->h) ; 


disp_str(21i, 41, 


oline); 


sprintf(oline, "Sector (R): Ox402x", pres->r); 


disp_str(22, 41, 


oline); 


sprintf(oline, "Sectors per track (N): Ox{402x", pres~->n); 


disp_str(23, 41, 


oline); 


sprintf(oline, "Last command : 0x%04x", pcmd->last_cmd) ; 


disp_str(24, 41, 


oline); 
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Chapter 12 
Hard Disk Drive Controller 


Introduction 


The hard disk controller provides an interface between a hard disk drive and 
the workstation microprocessor. The hard disk controller supports the following 
features: 


A 16-bit data path and an 8-bit input/output (I/O) path 
ECC correction 

Programmed I/O data transfers 

Field formatting with unlimited sector interleave 

Drives with a maximum of 16 heads and 1024 cylinders 


Hard Disk Controller Registers 


The hard disk controller has 13 registers that control hard disk operations and 
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primary and secondary I/O addresses. 
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Table 12-1 Hard Disk Controller Registers 


_heteatineiereismnonroncenntnntet 


Primary Secondary R/W Register 


senate RUNG iN Ogee ni meni en re SEERA 


oars 


Address 


Address 


erences ere een UHR tonneau cacy indo AHS desnare ovens enromemnicsnranenee rere ninineonentetnnensneesanoninyi 


OLFOH 
O1FLH 
OLFIH 
OLF2H 
O1F3H 
O1F4H 
O1F5H 
01F6H 
O1F7H 
O1F7H 
O3F6H 
O3F6H 
O38F7H 


“ebntnniitamdienncnevne iiss titer NO ein en nurses QURAN erie vietnam Ss OES SIDSA HSU ie ODP ED RE ia a 
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0170H 
O171H 
O171H 
0172H 
0173H 
0174H 
O175H 
0176H 
O177H 
0177H 
0376H 
0376H 
0377H 


Data register (16 bits) 
Write Precompensation Cylinder 
Error Register 

Sector Number 

Cylinder Number - Low Byte 
Cylinder Number - High Byte 
SDH (sector size, drive, and head) 
Command Register 

Status Register 

Hard Disk Register 

Alternate Status Register 

Digital Input Register 


stoners cee ennanase beeen 
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Data Register (01F0H/0170H) 
15 14 r 12 11 10 9 8 
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DATA REGISTER — HIGH BYTE 
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DATA REGISTER — LOW BYTE 


eS ee Cee ee, La eee CeRere ne: LOT eRe meer em ST 


Bit R/W_ Description 


15-0 R/W DATA 
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The data register provides a 16-bit data path to the sector buffer. This register 
is accessible only during execution of a read or write command. 


Except for the four ECC bytes of a read long or write long command, all data 
transfers are 16-bit transfers. 


After transferring the data of a read long or write long command, the four 
ECC bytes are transferred one byte at a time. The ECC bytes are transferred 
through the high byte. The hard disk controller requires a minimum of 2 “us 
status bit (status register bit 3) must be set. The status register is defined later 
in this chapter. 
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Write Precompensation Register (01F1H/0171H) 
7 6 5 4 3 2 1 0 
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CYLINDER NUMBER / 4 


| | 
es Se, eS |e ee ee a in. Lean rn 


Bit R/W Description 

7-0 W This register specifies the cylinder at which the hard disk control- 
ler begins applying write precompensation. The value written to 
this register is the desired cylinder number divided by 4. 
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Error Register (OLF1H/0171LH) 
7 6 5 4 3 2 1 0 


BLOCK 


<i inssvessotinineaniiinnonnse nano aonaw on 


Bit R/W DeSenpoep 
7 R BAD BLOCK DE’ r BOT 
Q = No error 
1 = The controller read a sector ID field that contained a bad 
block mark 
6 R ECC ERROR 
Q = No error 
1 = An ECC syndrome error was detected 


wT 


Always 0 

ID NOT FOUND 

Q = No Error 

1 = The hard disk controller failed to find the desired cylinder, 
head, sector, or size parameter within eight revolutions of the 
disk, or an ID field CRC error has occurred. 


3 R. Always 0) 
2 R ABORTED COMMAND DETECT 
Q = No error 
1 = The hard disk controller aborted a command 


If a command is issued while the status signal, DRIVE READY L, 
is inactive or the status signal, WRITE FAULT L is active, the 
ard disk controller sets this bit. 


1 R TRACK 0 ERROR 
Q = No error 
1 = The hard disk controller executed a restore command, issued 
2047 step pulses, and did not detect track 0. 
) R DAM NOT FOUND - Data Address Mark Not Found 
() = No error 
1 = The hard disk controller read the correct sector ID field, but 
it did not contain a data address mark. 
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For the following conditions, the error register contains valid data: 


e After a command completion interrupt. if the status register error bit 
(bit 0) equals 1, this register indicates the specific error condition, 


* -On power-up or receiving a diagnose command, the hard disk controller 
executes a set of diagnostic tests. On completion of those tests, the hard 
disk cannole: places a result code in this register. The result code is 
one of the codes listed in Table 12-2, For this condition, the status regis- 
ter error bit (bit 0) is ignored. 


Table 12-2. Hard Disk Controller eee Result nage 
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Value Meaning 

01 H No error 

02H WD1015/WD2010 controller error 

03H Sector Buffer RAM data error 

04H WD1015/WD11C00A-22 Register access error 
05H WD1015 ROM checksum or RAM data error 
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Sector Count Register (01F2H/0172H) 
7 6 5 4 3 2 1 0 


SECTOR COUNT 


TTS SE AEE TROT (AOI: (RATER! SOE RTS LF ES eS y meer a 


Bit R/W_ Description 
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7-0 R/W_ The sector count for an operation 


A value of 00H indicates a 256 sector transfer. 
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For a read, write, or read verify command, this register specifies the number of 
sectors transferred. For the format command, this register specifies the 
number of sectors to format. During a multiple sector operation, after each 
sector is transferred or formatted, the hard disk controller decrements the 
sector count, 


Sector Number Register (01F3H/0173H) 
7 6 5 4 3 2 1 0 
ie ei iis acid: i: is Cee: aes aii 


SECTOR NUMBER 
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Bit R/W_ Description 


7-0 R/W_ The first sector for an operation 


For a read, write, read verify, or format command, this register specifies the 
first sector of an operation. During multiple sector operations, after each sector 
is transferred or formatted, the hard disk controller increments the sector 
number. 
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Cylinder Number Low Register (01F4H/0174H) 
7 6 5 4 3 2 1 0 


CYLINDER NUMBER 
(LOW BYTE) 
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Bit R/W_ Description 


7-0 R/W_ Lower 8 bits of the 10-bit cylinder number 


number. The cylinder number high register specifies the 2 most significant 
bits, 


Cylinder Number High Register (01F5H/0175H) 
7 6 5 4 a 2 1 0 
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CYLINDER NUMBER 
(HIGH BYTE) 


Bit R/W_ Description 


7-2. R/W Always 0 
1-0 R/W_ Upper 2 bits of the 10-bit cylinder number 
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This register specifies the 2 most significant bits of the 10-bit cylinder 
number. The cylinder number low register specifies the 8 least significant 
bits. 
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SDH Register (01F6H/0176H) 
7 6 5 4 3 2 1 0 


HEAD SELECT 


Ss ee AER en nS 


Bit R/W_ Description 
7 R/W ECC SELECT 
0 = CRC used to check the data field of a sector 
1 = ECC used to check the data field of a sector (ROM BIOS 
requires ECC) 
R/W_ Always 0 
R/W DATA SIZE 
0 = 256 byte records (read operations only) 
1 = 6512 byte records 
4 R/W DRIVE SELECT 
0 = Hard disk drive 0 selected 
= Hard disk drive 1 selected 
3-0 R/W HEAD SELECT 
The binary value in bits 3-0 selects the corresponding head. To use 
bit 3 of this field, the ENABLE-HEAD-SELECT-BIT-3 (bit 3 of 
the hard disk register) must equal 1. Otherwise, bit 3 is ineffective 
and bits 2-0 have a range of 0-7. 
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Command Register (01F7H/0177H) 
7 6 5 4 3 2 1 0 
Secs ene ranean ee ane Nee NES aE Ee a TES aR 


COMMAND CODES 
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Bit R/W Description 
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7-0 W Hard disk controller command codes 
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When command codes are written to this register, the hard disk controller exe- 
cutes the command immediately. If the hard disk controller is busy (status reg- 
ister bit 7 equals 1), command codes cannot be written to the command 
register. When the hard disk controller detects a command error condition, the 
hard disk controller aborts the command and sets the ABORTED COMMAND 
DETECT bit (error register bit 2). Some of the common command error condi- 
tions are: 


WRITE FAULT is active 
DRIVE READY is inactive 
SEEK COMPLETE is inactive 
Command code was invalid 
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he hard disk controller has the following commands: 


Restore 

Seek 

Read Sector 
Write Sector 
Format Track 
Read Verify 
Diagnose 

Set Parameter 
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Restore Command 


RESTORE COMMAND 


TA eee eee Teme nae 


6 


0 


5 


0 


Description 
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STEP RATE 
0000 = 35.0 us 


0.5 ms 
1.0 ms 
1.5 ms 
2.0 ms 
2.5 ms 
3.0 ms 


RESTORE COMMAND (Always 0001) 


1000 = 
1001 = 
1010 = 
1011 = 
1100 = 
1101 = 
1110 = 


2 1 0 
ee eee rhe rae ee ee 


STEP RATE 
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01ll= 3.5 ms 1111 = 16.0 ps 
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Until a terminating condition occurs, the hard disk controller issues step pulses 
to the selected drive. The terminating conditions are: 


* The TRACK 0 signal from the drive becomes active, which indicates a 
successful completion of the command. In this case, the hard disk con- 
troller sets SEEK COMPLETE (status register bit 4) to 1. 


* The hard disk controller issues 2047 step pulses, which causes a 
TRACK 0 ERROR (error register bit 3). 

* The DRIVE READY signal becomes inactive, which causes an 
ABORTED COMMAND DETECT (error register bit 2). 


e¢ The WRITE FAULT signal becomes active, which causes an ABORTED 
COMMAND DETECT (error register bit 2), 


While a restore command is in progress, the SEEK COMPLETE signal from 
the drive controls the step rate. Bits 3-0 set the implied seek step rate. On 
termination of this command, the hard disk controller generates an interrupt to 
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Seek Command 


7 6 i 4 3 2 1 0 


alicia ac eee aa (aaa aaa aaa ase See ee eae ee ne a ees 


SEEK COMMAND STEP RATE 


| 0 pi 1 1 


Bit Description 
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7-4 SEEK COMMAND (Always 0111) 


3-0 STEP RATE 

0000 = 35.0 us 1000 = 4 
0001 = 0.5 ms 1001 = 4. 
0010 = 1.0 ms 1010 = 5.0 ms 
0011 = 1.5 ms 1011 => 65.5 
0100 = 2.0 ms 1100 = 6 

0101 2.5 ms 1101 = 6.5 ms 
0110 = 3.0 ms 1110 = 3.2 us 
0111 = 3.5 ms 1111 = 16.0 us 
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Until a terminating condition occurs, the hard disk controller issues step pulses 
to the selected drive. The terminating conditions are: 


¢ The SEEK COMPLETE signal from the drive becomes active, which in- 
dicates a successful completion of the command. In this case, the hard 
disk controller sets SEEK COMPLETE (status register bit 4) to 1. 


* The DRIVE READY signal becomes inactive, which causes an 
ABORTED COMMAND DETECT (error register bit 2). 


« The WRITE FAULT signal becomes active, which causes an ABORTED 
COMMAND DETECT (error register bit 2). 


The seek command moves the read/write heads to the cylinder specified by the 
10-bit value in the registers cylinder low and cylinder high. Bits 3-0 set the 
implied seek step rate and control the step rate of the seek command. After 
the hard disk controller starts the seek, the hard disk controller generates an 
ready to accept another command. It does not indicate that the seek is com- 
plete. To determine when the seek is complete, the application program or 
driver must monitor status register bit 4. When status register bit 4 equals 1, 
the seek is complete. 
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Read Sector Command 
7 6 5 4 2 2 i 0 
READ SECTOR COMMAND READ |RETRIES 
LONG |DISABLE| 
0 0 1 0 0 0 
Oe ee ae Le ee ene! Se eed alee mee | eee ee Oe idichatereteb See OTe | 
Bit Description 
7-2 READ SECTOR COMMAND | bAieeas 001000) 
1 READ LONG 


0 = After transferring a sector of data. the hard disk controller 
calculates and checks the data field ECC. If a correctable 
error occurs, the hard disk controller sets CORRECTED 
DATA (status register bit 2). If an uncorrectable error occurs, 
the hard disk controller sets ECC ERROR (error register bit 
6) and ERROR (status register bit 0). If an uncorrectable 
error occurs during a multiple sector read, the multiple sector 
read is terminated. 


1 = The hard in controller does not calculate the data field 
ECC. After transferring a sector of data, the hard disk con- 
troller eae the four data field ECC bytes. The four ECC 
bytes are transferred one at a time in the high byte of the 
word. Until DRQ (status register bit 3) equals 1, an ECC byte 
is not ey for transfer. The hard disk controller requires at 
least 2 us between ECC byte transfers. 


Q) RETRIES DISABLE 
Q = Retries enabled 
1 = Retries disabled 


To read a sector from the hard disk. the hard disk controller must 
first find the sector. To find the correct sector, the hard disk con- 
es selects the indic ca ated bees duced any am pe Seen vain 


disk canaries beans scanning re track for av valid sector ) ID field. 
A valid sector ID field contains the cylinder, head, sector number, 
and size information that the hard disk controller is searching: for. 
The hard disk controller counts each index pulse as an attempt to 
read a valid sector ID. 
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Bit Description (Read Sector Command - cont.) 
If retries are enabled and the hard disk controller fails to read a 
valid ID field within ten attempts, the hard disk controller performs 
an auto-seek and an auto-scan. If the hard disk controller fails to 
read a valid ID field within an additional ten attempts, the hard 
disk controller sets ID Not Found (error register bit 4) and ERROR 
(status register bit 0). 
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If retries are disabled and the hard disk controller fails to read a 
valid ID field within two attempts, the hard disk controller sets 

ID Not Found (error register bit 4) and ERROR (status register 
bit 0). Also, the hard disk controller does not perform an auto-seek 
or an auto-scan, 


unsorted ROA ON 


The read sector command transfers the specified number of sectors from the 
selected drive. If the heads are not positioned at the specified cylinder, the con- 
troller performs an implied seek to the proper cylinder. The step rate used is 
that of the most recently executed restore or seek command. Multiple sector 
reads can cross head and cylinder boundaries. If the DRIVE READY signal 
becomes inactive, or the WRITE FAULT signal becomes active, the hard disk 
controller terminates the command and sets ABORTED COMMAND DETECT 
(error register bit 2) and ERROR (status register bit 0). 


When each sector is stored in the sector buffer and ready to be read by the 
CPU, the hard disk controller generates an interrupt request to the CPU. The 
hard disk controller does not generate an interrupt request to indicate com- 
mand completion. 


12-14 Hard Disk Drive Controller - Hardware Description 


Write Sector Command 


WRITE SECTOR COMMAND |RETRIES | 


DISABLE 
0 0 1 1 
ECE, AIO MENES: AT NLR OE OT® Nee eNare ee 
Bit Description 
7-2 WRITE SECTOR COMMAND (Always 001100} 
1 WRITE LONG 


Q = The hard disk controller calculates the data field ECC and ap- 
pends the ECC to the data field. 


1 = The hard disk controller does not calculate the data field 
ECC. After accepting a sector of data, the hard disk control- 
ler accepts the four data field ECC bytes. The four ECC bytes 
are transferred one at a time in the high byte of the word size 
data register. Until DRQ (status register bit 3) equals 1, an 
ECC byte is not ready for transfer. The hard disk controller 
requires at least 2 us between ECC byte transfers. 


) RETRIES DISABLE 
0 = Retries enabled 
1 =  Retries disabled 


To write a sector from the hard disk, the hard disk controller must 
first find the sector. To find the correct sector, the hard disk con- 
troller selects the indicated head, performs any implied seek, and 
waits for the index pulse. On receipt of the index pulse, the hard 
disk controller begins scanning the track for a valid sector ID field. 
A valid sector ID field contains the cylinder, head, sector number, 
and size information that the hard disk controller is searching for. 
The hard disk controller counts each index pulse as an attempt to 
read a valid sector ID. 


If retries are enabled and the hard disk controller fails to read a 
valid ID field within ten attempts, the hard disk controller performs 
an auto-seek and an auto-scan. If the hard disk controller fails to 
read a valid ID field within an additional ten attempts, the hard 
disk controller sets ID Not Found (error register bit 4) and ERROR 
(status register bit 0). 
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Bit Serpe ei (Write sanded Command - cont.) 
‘If tense are dieanice fad ie hard disie éonieollee fails to yen 
valid ID field within two attempts. the hard disk controller sets 
ID) Not Found (error register bit 4) and ERROR (status register bit 
0). Also, the hard disk controller does not perform an auto-seek or 
an auto-scan. 


sso epimers Ra RASS mentees ON SAAS iene See ane END ROSSA HESSEN SSSI SESE SSS ta DHSS EINES NS APSO INS 
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The write sector command transfers the specified number of sectors to the se- 
lected drive. If the heads are not positioned at the specified cylinder, the con- 
troller performs an implied seek to the proper cylinder. The step rate used is 
that of the most recently executed restore or seek command. Multiple sector 
writes can cross head and Pilon boundaries. If the DRIVE READY signal 
becomes inactive, or the WRITE FAULT signal becomes active, the hard disk 
controller terminates the command and sets ABORTED COMMAND DETECT 
(error register bit 2) and ERROR (status register bit 0). 


After the write sector command has been issued, immediately write the first 
sector of data to the data buffer (monitor DRQ, status register bit 3). When 
ras sector 1s written to the hard disk, the hard disk controller generates an 

nterrupt request to the CPU. The hard disk controller does not generate an 
aun request to indicate command completion. 
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“ae” 


Format Track Command 


/ 6 5 4 3 2 | 0 
nN 


FORMAT TRACK COMMAND 


0 1 0 1 0 0 0 8) 
See: ee en (Ee eee! nee | es: eee ene 
Bit Description 
7-0 FORMAT TRACK COMMAND (Always 01010000) 


Using data from the internal registers and the sector buffer, the format track 
command formats a single track at the specified cylinder and head location. 
Before formatting a hard disk, the SDH register must be loaded and a restore 
command must be issued. Assuming that a series of sequential format track 
commands are issued to format the hard disk, only one restore command is 
required. Prior to each format track command, the sector count register must 


be loaded with the number of sectors per track and the cylinder registers must 


be loaded with the cylinder number, 


Instead of providing normal read/write data, the sector buffer provides sector 
header information. Also, the organization of this sector header information 
specifies the sector interleave. Table 12-3 lists the data (in memory order) that 
is required for an interleave factor of 2. The data transfer using this table is 

256 words long. A bad block is specified by replacing the 00H (normal block 
mark) with an 80H (bad block mark). The sector interleave table is loaded into 
the sector buffer in the same manner as a sector write. That is, the format 
track command is issued and the sector buffer is loaded immediately (monitor 
DRQ, status register bit 3). 


When a track has been formatted. the hard disk controller clears the sector 


buffer to zeros and issues a command completion interrupt. Following the next 


format track command, the sector buffer must be reloaded. 


The hard disk controller does not produce any error reports for this command. 


Hard Disk Drive Controller - Hardware Description 12-1 


Table 12-3 aeemory nage of a Sector miberleave oe 
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Offset 2. Byte Seaiune e 
Sector Sector 
Number Status (OOH = Good, 80H = Bad) 
(High Byte) (Low Byte) 


00H O1H 00H 
02H OAH OOH 
04H Q2H OOH 
O6H OBH OOH 
08H 03H OOH 
OAH OCH OOH 
OCH 04H OOH 
OEH QDH 00H 
10H 05H OOH 
12H OEH OOH 
14H O6H 00H 
16H OFH OOH 
18H O7H 00H 
1AH 10H OOH 
1CH 08H OOH 
LEH 11H OOH 
20H 09H QOH 
22H FFH FFH 
FFH FFH 
FRH FFH 

FFH FFH 
FFH FFH FFH 
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Read Verify Command 
7 6 S 4 3 2 1 0 
Ee er Re eee a en a a ee ee Po Eee RE 


READ VERIFY COMMAND |}RETRIES 


| DISABLE 
1 0 0 0 0 0 
OTe REE Sena Eo ERTS Kee ea: LIne Neen antennae Seeman meee 
Bit Description 
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7-1 READ VERIFY COMMAND (Always 0100000) 
Q RETRIES DISABLE 


) = Retries enabled 
1 = Retries disabled 


To read a sector from the hard disk, the hard disk controller must 
first find the sector. To find the correct sector, the hard disk con- 
troller selects the indicated head, performs any implied seek, and 
waits for the index pulse. On receipt of the index pulse, the hard 
disk controller begins scanning the track for a valid sector ID field. 
A valid sector ID field contains the cylinder, head, sector number, 
and size information that the hard disk controller is searching for. 
The hard disk controller counts each index pulse as an attempt to 
read a valid sector ID. 


If retries are enabled and the hard disk controller fails to read a 
valid ID field within ten attempts, the hard disk controller performs 
an auto-seek and an auto-scan. If the hard disk controller fails to 
read a valid ID field within an additional ten attempts, the hard 
disk controller sets ID Not Found (error register bit 4) and ERROR 
(status register bit 0). 


If retries are disabled and the hard disk controller fails to read a 
valid ID field within two attempts, the hard disk controller sets 

ID Not Found (error register bit 4) and ERROR (status register 
bit 0). Also, the hard disk controller does not perform an auto-seek 
or an auto-scan, 


Spinone tnt nmerco tenner 
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The read verify command scans the data in the specified number of sectors of 
the selected drive. As the hard disk controller scans the data of each sector. it 
calculates the ECC bytes and verifies that the ECC bytes calculated from the 
data and ECC bytes read from the disk agree. If the heads are not positioned 
at the specified cylinder, the controller performs an implied seek to the proper 
cylinder. The step rate used is that of the most recently executed restore or 
seek command. Multiple sector reads may cross head and cylinder boundaries. 
If the DRIVE READY signal becomes inactive, or the WRITE FAULT signal 
becomes active, the hard disk controller terminates the command and sets 
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ABORTED COMMAND DETECT (error register bit 2) and ERROR (status 
register bit 0). 


To indicate command completion or an error condition, the hard disk controller 
generates an interrupt request to the CPU. 
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Diagnose Command 


] 6 iS 4 3 2 1 0 
eee ep ca a ea 


DIAGNOSE COMMAND 


Bit Bestia eee 


ersten gnome sonoma esnseeneracleatesirsarontesiansypnupinnenremsontnanoNlai ttn teeters ECHO meen 


7-0 _ DIAGNOSE COMMAND ne jays | atin 


arin ets obese eNO ONIN eee eR eimai tint LYON eine nme nie ein ims inanimate ayia nn seine ener HIER etn, 


on rec ie OF this ans ae ed eee ee oller ex sukanied a set tof aes 


se error Seti) ieee Table 12 -4), The enteral ROM, i inter a RAM, BCC | cir- 
cuitry, and data path circuitry are tested. When the diagnostic tests complete, 
the hard disk controller loads the appropriate code into the error register. To 
indicate command completion, the hard disk controller generates an interrupt 
request to the CPU. 


es a eee eonaant ae ee in Pe error mover : make ene OF 


ene r resu it ee 


Table 12-4 Hard Disk sealinietaos EP AREROE TS Result EPOnee: 


sneer tenet rainawissesens wont onto sneacnn sensi nas umpbsiisenSiannmneeSeihiNhteieteneOtaNt oe eset tsa fone eee OIE eH 


Value - Mez ne 
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O1H No error 

Q2H WD1015/WD2010 controller error 

O3H Sector Buffer RAM data error 

04H WD1015/WD11C00A-22 Register access error 
05H WD1015 ROM pene ksum or RAM aoa error 


“ements ety SHAM EP NES SSPHDAAEDOEN NO RAREECOI Sa A IA marina WIN SBEASNHEeeti AO BADAOSSOnEDNHN Linker mates hginsvnnesnei sandman nn abn aon sneering 
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Set Parameters Command 


7 6 5 4 > 2 1 0 
STEEEIEEIIIET EERIE TEEEEREREIEREIE TEEEEEEEEEEeD EEEEEEEEEEEE Ee 


SET PARAMETERS COMMAND 


Bit Description 


seme aie ADAIR ST Hs 
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7-0 SET PARAMETERS COMMAND (Alwa: ays es aie 


amrannsineiunidninsonsoi Sen Mbeiiiens ing ntesepmemeenontteenareensonsaliteinonisiuseiniaonausnnivinisirinth 


“sneer aaeneseraeten iiss inpdne ome reer onan ieenORNaN nearing oli sigiiaiiietantitansietennnnstnncsretsciniSIO 


This command sets the drive parameters for the maximum number of heads 
and sectors per eo ees to ee ons: Seah we ue CEs shaban must 


Sec tor -C cane Pees aise be set. This Sraaena: mee * reaned sone e any 


multiple sector operations are performed. To indicate command completion, the 
hard disk controller generates an interrupt request to the CPU. 
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Status Register (01F7H/0177H) 
fi 6 2 4 a - 1 0 


tts oer GA 


 ssmrenvinsineeionestnnnesitieni iim ino 


Bit R/W_ Description 


Spon orienta nena onininnnnennetesietnetnnansunont 


7 RR BUSY 


bonnaroo ears ao seh ees smi iran ann seater aM 


status and error registers contain valid data. 
1 = Hard disk controller is busy. The error register contains 
invalid data. Only this status register bit is valid. 


This bit must be polled before reading any register. 


6 R DRIVE READY 
Q = Drive is not ready. Read, write, and seek commands are 
inhibited. 
1 = _ Drive is ready. If bit 4 equals 1, read, write, and seek 
commands are possible. 


5 R WRITE FAULT 
Q = No error 
1 = Improper operation of the drive. All commands will be 
terminated with an aborted command error. 


4 R SEEK STATUS - Seek Complete 
Q = Seek operation, direct or implied, is incomplete. 
1 = Seek operation is complete (read/write heads are in position). 


3 R DRQ - Data Request 
0 = Do not read or write the sector buffer 
1 = Read or write the sector buffer as indicated by the last 
command issued. 


y, R CD - Corrected Data 
(. = No error 
1 = The sector read from the drive resulted in a correctable ECC 
error. Correctable errors do not cause multiple sector 
transfers to terminate. 
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Bit R/W 


‘Anemia nnnarisionneaninsininient 


Senecio cSiiisnderrenninann 


‘ile 


Description (Status Register - cont.) 


rns CAM URE NU acs tte ORPHANS ce amanactor entice eed SAnnrin gy scm ima aN Wirt OMOEA 


Q = Index not in position and not detected 


1 = Index in position and detected 
ERROR 


Q = No error 

1 = A nonrecoverable error has occurred. The error register con- 
tains the error status. 

The next command issued to the hard disk controller, clears this 

bit. If the hard disk controller sets this bit during a multiple sector 

transfer, the transfer is terminated. 
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Alternate Status Register (03F6H/0376H) 


This read-only register duplicates the status register (01 F7H/0177H). 


Hard Disk Register (O3F6H/0376H) 
F 4 6 5 4 = 2 1 0 


sap oteseeenrnemnasninheaerinaescr emma 


RESET | INTRPT 
| ENABLE 


Bit R/W_ Description 


lineation primis 


AHA IASON SESS SPINOR IRIS OL SDAA AAAS ste SAM NHN tte ONAN ete manent sioiocesencaeuntinteoetagietaiiyepaaitinnnnetontete i iynooinenreensnasn ei gnngneonseenennsen nso asosnmnseiidinaDiesnsetepsat esate 


7-4 W Always 0 


3 W ENABLE HEAD SELECT BIT 3 
0 = Reduced write current enabled 
1 = Head Select Bit 3 (SDH register bit 3) enabled. See the 
SDH register description. 


2 WwW RESET 

0 = Hard disk controller enabled. 

1 = When set, the hard disk controller enters the reset state and 
remains there until this bit is cleared. This bit must stay set 
for a minimum of 5 ws. When this bit is cleared, the hard 
disk controller performs a set of power-up diagnostic tests 
and the busy bit (status register bit 7) remains set until tests 
are completed. 

1 Ww INTRPT ENABLE - Interrupt Enable 

0 = Hard disk controller interrupt buffer is enabled. Setting this 
bit does not clear the hard disk controller interrupt output. 
When this bit is cleared, any pending interrupts will occur. 

1 = Hard disk controller interrupt buffer is disabled. 


This bit enables or disables a buffer between the hard disk control- 
ler output and the peripheral interrupt controller input. 


0 WwW Always 0 
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Digital Input Register (03F7H/0377H) 
7 6 5 4 3 2 1 0 


smnsiaeiinntciteii. ¥igcaaesaninneenoncnsingn tenement aac prensa yNSO voids psec 


| HEAD HEAD | 
|SELECT | SELECT | SELECT 
|SIGNAL |SIGNAL | SIGNAL 


Bit R/W_ Description 


vos institaetttntsitin etstMntieyarinnomaune UIA remo eto RNURON 


7 R Reserved (Va ine undefined) 


6 R WRITE GATE SIGNAL 

0 = Write gate signal is active. 

1 = Write gate signal is inactive. 
oD R Always 1 
4 R HEAD SELECT SIGNAL 2 

Q = Head select signal 2 is active. 

1 = Head select signal 2 is inactive. 
3 R HEAD SELECT SIGNAL 1 

0 = Head select signal 1 is active. 

1 = Head select signal 1 is inactive. 
2 R HEAD SELECT SIGNAL 0 

0 = Head select signal Q is active. 

1 = Head select signal 0 is inactive. 
1 R DRIVE SELECT SIGNAL 1 

0 = Drive select signal 1 is active. 

1 = _ Drive select signal | is inactive. 
0 R DRIVE SELECT SIGNAL 0 

(} = Drive select signal 0 is active. 

1 = _ Drive select signal 0 is inactive. 
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Programming Example 


The following programming example demonstrates: 


Initializing the hard disk controller 
Recalibrating the hard disk drive 
Seeking to a track 

Hard formatting a hard disk 


* ¢ # @ 


CAUTION 

Improper programming or improper operation of this device can 
cause the VAXmate workstation to malfunction. The scope of 
the programming example is limited to the context provided in 
this manual. No other use is intended. 
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#include "kyb.h" 
#include "example.h" 


JCI IOC OGIO IOI GIG CGI ICO ISIO I IC K i deck dc dee gles at ak akc / 


/* define constants used in hard disk controller example 
JCC GO tok lokokgoick Ga iodo k kokokokolok Io a ok kok ak ok ak kes ok ie ok ac ake ae ak ake ok ake ake ake ake ak ok ak ak ake tek / 


#define PRI_BASE 
#define ALT_BASE 
#define HDR_ASR 


#define DIG_INP 


OxO3f7 


OxO03f6 


Ox01f0 /* primary base address of controller regs 
0x0170/* alternate base address of controller regs 


/* address of hard disk 


/* and alternate status 


/* address of digital input 


/* define constant divisor for write precompensation cylinder 


#define WPC_DIV 0x04 


/* define bit values for 


0x80 
0x40 
0x10 
0x04 
0x02 
0x01 


#define 
#define 
#define 
#define 
#define 
#define 


ERR_BBD 
ERR_DFE 
ERR_ID 
ERR_ABR 
ERR_TZE 
ERR_DAMNF 


/* define bit values for 
0x04 


0x02 
0x01 


#define HEAD_SEL3 
#define RESET_HDC 
#define INT_ENA 


/* define bit values for 


#define SDH_ECC 0x80 
0x00 


#define SDH_2 
5 0x20 


56 
#define SDH 3 


912 


oes 


12+ 98 


error status register */ 


/* bad block detected * 
/* CRC/ECC error in data field * 


could not locate correct 


/* command aborted ° 


/* track ze 


/* data address mark not found 


hard disk register */ 


jf oh 


sdh register */ 


/* select ecc mode for data 


/* sector s 
/* sector s 
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Oo @error 


enables third head select bit * 
/* resets hard disk controller * 
/* enables hdc interrupts to CPU * 


ize = 


«/ 


register  f 
register */ 
register *& f 


*/ 


ID field 


field +/ 


256 *«/ 
512 */ 


ize = 


/* define bit values for status register */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 


STAT_BSY 
STAT_RDY 
STAT_WF 

STAT_SC 

STAT_DRQ 
STAT_DWC 
STAT_ERR 


0x80 
0x40 
0x20 
0x10 
0x08 
0x04 
Ox01 


/* define bit values for 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


SR_35US 

SR_O_5MS 
SR_1_OMS 
SR_1_5MS 
SR_2_0OMS 
SR_2_5MS 
SR_3_OMS 
SR_3_5MS 
SR_4_OMS 
SR_4_5MS 
SR_5_OMS 
SR_5_5MS 
SR_6_OMS 
SR_6_5MS 
SR_3_2US 
SR_1_6US 


CMD_IC 
CMD_MSF 
CMD_LM 
CMD_TRY 


CMD_REST 
CMD_SEEK 
CMD_READ 


CMD_WRITE 


CMD_SCAN 


CMD_FRMAT 


CMD_CC 
CMD_PARM 


0x00 
0x01 
0x02 
0x03 
0x04 
0x05 
0x06 
0x07 
0x08 
0x09 
Ox0a 
OxOb 
OxOc 
Ox0d 
Ox0e 
OxO0f 


0x08 
0x04 
0x02 
Ox01 


0x10 
Ox70 
0x20 
0x30 
0x40 
0x50 
0x08 
0x91 


/* hde busy 


/* write fault * 


/* seek complete 
/* data request 


/* data was corrected * 
/* nonrecoverable error > 


command register */ 


/* step rate = 35 us 
rate = 
rate = 
rate = 
rate = 
rate = 
rate = 
rate = 
rate = 
rate = 
|} rate = 
rate = 
rate = 
2p rate = 
rate = 
rate = 


fw NN ee © 


Ww 


us 
us 


= 
Aananonononononon 

= 

2 


/* interrupt control » 


/* multiple sector flag 
/* long mode read and write 


/* disable retries > 


command 
command 
command 
command 
command 
command 
command 
command 


/* restore 

/* seek 

/* read 

/* write 

/* read/verify 

/* format 

/* compute correction 
/* set parameter 
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JDO CRO ORI IO OIG OO II i kok kook ak ak i ea aca de dea ake ake akc cake ake ake ae a fe ake // 


/* declare structures used in hard disk controller example 
(DAC ORIC OCI OIG Io a I IOI eek kok sek leak ak a ok ka cok 2k oe ak akc ae a ak ake ake ae skate ake ake ated / 


typedef struct 


{ 
unsigned char sec_buf; /* (R/W) sector buffer 
unsigned char err_wpc; /* (R) error reg 
/* (W) write precompensation cylinder 
unsigned char sc; /* (R/W) sector count 
unsigned char sn; /* (R/W) sector number 
unsigned char cyl_low; /* (R/W) lower 8 bits of cylinder number 
unsigned char cyl_hi; /* (R/W) upper 2 bits of cylinder number 
unsigned char sdh; /* (R/W) sdh register 
unsigned char csr; /* (R) status reg, (W) command reg 
} HDC; 


typedef struct 
a! 


HDC «base; /* primary or alternate base address of controller reg 


int busy; 
int retry; 


/* busy flag 
/* retry count 


unsigned int cyl; /* cylinder number 
unsigned char last_cmd; /* last command sent to hdc 
unsigned char ecm; /* error correction method 
unsigned char srt; /* step rate time 
unsigned char ds; /* drive select O - 3 
unsigned char hs; /* selected head number 


unsigned char sc; 
unsigned char sn; 
unsigned char eot; 


/* sector count 
/* sector number 
/* end of track 


unsigned char fegpl; /* format gap length 


unsigned char nd; 

unsigned char ss; 

unsigned char t; 
} HDC_CMD; 
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/* non-DMA mode 
/* sector size 
/* retry flag 


/ 


typedef struct 
{ 


unsigned int cc; /* cylinder count */ 

unsigned int wpc; /* write precompensation cylinder */ 

unsigned int hc; /* head count */ 

unsigned int spt; /* sectors per track */ 
} HDD; 


typedef struct 

4, 
unsigned int cyl; /* cylinder number */ 
unsigned char error; /* error code/status */ 
unsigned char sc; /* sector count */ 
unsigned char sn; /* sector number *«/ 
unsigned char sdh; /* sdh register */ 
unsigned char status; /* status register */ 

} HDC_RESULT; 


[DCCC OIG CIO OI GIGIGI GO IOI I Ok kk IR IC IOI IO ac ae fe a ie ae ako ok ak ake // 


/* declare space for hdc parameter data + / 
[ORO IO OGIO i kk GIO ICI kk kok kok a a IC aa i ok ak ake ake ak ake ake ake ak ake ako ak ok ake / 


HDD hdd[2] = /* hard disk descriptors */ 
{ 
4 O46, 200,..4,. 47 +; 
4 615.0300, 4, 17 3 
rs 
HDC_CMD hdc_cmd; /* command data */ 
HDC_RESULT hdc_result; /* result data */ 
int hdc_buff [256]; /* hdc I/O buffer */ 


/ 6 che ge oie ole oe oe ke oft ole ok: ofe ole ole ole ke oh ok te ok cle ke oe ote she oh of ote oe oko oie vik oe ok ok oe ke ote ke ote oe oe oie ole fe ce ke oie ot oe ote ae He ole ole ok okt oe ool Mc ake ake oe ke oe ok oe oe oe ok / 
d a 


/* hds() - select the desired drive * f 
[CGO OIC ISOS IC OGG GCG a ick ac ata ok sek ak akak ae / 


hds() /* select error correction method, sector size, drive, and head */ 


HDC *phdc = hdc_cmd.base; /* pointer to controller registers * f 


outp(&phdc->sdh, hdc_cmd.ecm | hde_cmd.ss | (hdc_cmd.ds << 4) | hde_cmd.hs); 


} 
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GCC OIG IO OOO oko i IG II IG kok Gk ke ake ak ok ok ak kerk sk ak ke ake ok ake keke ak ak ake / 


/* wait_hdc() - wait for hard disk command to complete * / 
rs Dk kook Kk RHO OR ko kk tdi ok ke ok oko ok se ake ake okie ake ake ok ake akc ak oe aie oft oe ke ak oe fe ake oe ae of ale afc of akc ake afe ake ake ake okt ake ake ok ake fp 


wait_hdc() 

{ 

HDC *phdc = hdc_cmd.base; /* pointer to controller registers */ 
while (hdc_cmd. busy) /* wait until interrupt occurs */ 


/* busy bit should be clear, but just in case, */ 
while(inp(&phdc->csr) & STAT_BSY) /* wait until busy bit is clear */ 


if(inp(&phdc->csr) & STAT_ERR) /* if error condition */ 

hdc_result.error = inp(&phdc->err_wpc) ; /* read error register */ 
else hdc_result.error = 0; /* mark no error */ 
switch(hdc_cmd.last_cmd) /* discover last command issued */ 
1. 


while((inp(&phdc->csr) & (STAT_RDY | STAT_SC)) != (STAT_RDY | STAT_SC)) 


4 


break: 


case CMD_SEEK 
while((inp(4phdc->csr) & (STAT_RDY | STAT_SC)) != (STAT_RDY | STAT_SC)) 


i 


break; 


case CMD_FRMAT: 
break; 


default 
break; 
- 
hdc_result.sc = inp(&phdc->sc) ; /* read sector count register */ 
hdc_result.sn = inp(&phdc~->sn) ; /* read sector number register */ 
hdc_result.cyl = inp(&phdc->cyl_low) ; /* low 8 bits of cyl */ 
hdc_result.cyl |= inp(&phdc->cyl_hi) << 8; /* high 2 bits of cyl */ 
hdc_result.sdh = inp(&phdc->sdh) ; /* read sdh register */ 
hdc_result.status = inp(&phdc->csr) ; /* read status register */ 
dsp_hdc_stat() ; /* display result status */ 
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/* hdc_issue() - issue all hdc commands * | 
| HOR Re OI OG do OR do ok OR kok de kk do ok koko ak ae ok ok ak ok kc ak ok ok ake ok ake ake ae ok aks ok ake oe ofc ate ake otek / 


hdc_issue (cmd) 


int cmd; /* desired command */ 


{ 
HDC *phdc = hdc_cmd.base; 
char oline[20]; 


hdc_cmd.last_cmd = cmd; /* set last command issued */ 
switch(cmd) 
{ 
case CMD_REST: /* recalibrate ? */ 
hdc_cmd.cyl = Q; 
hdc_cmd.hs = QO; 
cmd |= hdc_cmd.srt;: /* restore command */ 
break; 


case CMD_SEEK: /* seek ? */ 
cmd |= hdc_cmd.srt; /* seek command */ 
break; 


case CMD_SCAN: /* read ID ? */ 
cmd |= hdc_cmd.t; /* scan id command */ 
break; 


case CMD_READ: 7 # read data ? * f 
case CMD _WRITE: re: write data ? tf 
break; 


default: 
break; 
J | 
outp(&phdc->err_wpc, hdd[{hdc_cmd.ds].wpc >> 2); /* write the wpc reg */ 


outp(&phdc->sc, hdc_cmd.sc); /* write.the sector count */ 
outp(&phde->sn, hde_cmd.sn) ; /* write the sector number */ 


outp(&phdc->cyl_low, hdc_ecmd.cyl]l) ; /* write 8 low bits */ 
outp(&phdc->cyl_hi, hde_cmd.cyl >> 8); /* write 2 high bits */ 


hds() ; /* select appropriate drive */ 
outp(&phdc->csr, cmd); /* write the command */ 


hdc_cmd.busy = TRUE; 


pet 
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J/* hide 301 (C -- initialize hard disk controller and interrupt vector * f 
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hdc_init() 
{ 


outp(HDR_ASR, RESET_HDC) ; /* reset the hdc */ 
/* must be reset for minimum of 5 us */ 
iv_init (0x76) ; /* initialize the interrupt vector */ 
imask(1, 6, ON); /* enable PIC input */ 
outp(HDR_ASR, INT_ENA) ; /* hde not reset and allow interrupt */ 

} 


sf Be be oh ke oe she oft ke she of ok ok oe ote ok okt ole ake oe oe oe ote oe oe oe ok wie he ole oe ote ke oe oe he the he he he oe oe oe ok He he he he che ote oh ke he ke ke ve he oe he oe ode ote ode ake he he ake oe he oe ee / 


/* hdc_rest() - restore hard disk controller and interrupt vector tf 
[7k Rk tke ok kk ok ke ake kk a ak kok ok kek ok kc oe ake ake akc oie ok ke akc fe ok oko fe ok ok ac ake kc ic oe ak oke oft fe akc akc fe ok ake ake fe ake ake ofc ale ake ate akc ake / 


hdc_rest () 

{ 
outp(HDR_ASR, RESET_HDC) ; /* reset the hdc */ 
imask(1, 6, OFF); /* disable PIC input */ 
iv_rest (0x76); /* restore the interrupt vector */ 
outp(HDR_ASR, INT_ENA) ; /* hdc not reset and allow interrupt */ 
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/* hdc_int_hand() - hdc interrupt handler * | 


/ she ote ahs fe ode okt ole ke oie ote ok pk ote ok ke ok fe ofc okt ote obs ole ok ods oe che os ole of ote ok ole ois ole ode ole oe ote oe ode ake ote oft ok ote ok oie ofe oie ole ofe ole ole ois whe ake os oie oe ote ole ole ofc ote tie ake fe ad fe ots oie / 


hdc_int_hand() 
{ 


HDC *phdc = hdc_cmd.base; /* pointer to controller registers */ 


hdc_result.status = inp(&phdc->csr) ; /* read status register */ 


hdc_cmd.busy = FALSE; /* no longer busy */ 
eoi(i); 


} 
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/* hdc() - execute hard disk controller examples * ff 
/ ole ok ole Me ke ie he Me ke oe oie oie te oe oie oe he ode ake he ae ste ode oe oe ke ke he fe he okt he ake nhc the ohe okt ke abe the ne ode she oe she he he ote ok he he he oie he fe abe ode ode ke he he ke oe oe ode de ae he he ke ok / 


hdc () 

{ 

static MESSAGE mhdc[] = /* hdc menu */ 
{ 

3, 27, "Hard Disk Controller Example" }, 

5, 27, "Fi. Recalibrate" }, 

6, 27, "F2. Head +" }, 
7, 27, "F3. Head -" } 
8, 27, "F4. Seek +" } 
9, 27, "F5. Seek -" } 
10, 27, "F6. Read ID" }, 

11, 27, "F7. %** Format Disk ** (Erases data)" }, 
12, 27, "FiO. Return to Main menu" }, 
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On: Oy, On F: 
ba 
char line[512]; /* to hold input line */ 
char oline[512]-: /* to hold output line */ 
unsigned int cyl; /* loop control */ 
unsigned int head; /* loop control */ 


HDC *phdc; 
int *pi; 
int i; 


disp_menu(mhdc) ; /* display the hdc menu */ 
hdc_cmd.base = (HDC *)PRI_BASE; /* controller addressed at primary */ 
hdc_cmd.ecm = SDH_ECC; 

hdc_cmd.ss = SDH_512; 

hdc_cmd.ds = Q; 

hdc_cmd.hs = hdd[0].hc; 

hdc_cmd.sc = hdd[0].spt; 


hdc_cmd.srt = SR_1_5MS; /* assign step rate */ 
phde = hdc_cmd.base; 
hdc_issue(CMD_PARM) ; /* set parameters */ 


wait_hdc() ; 

hdc_cmd.cyl = hdc_result.cyl1; 
dsp_hdc_stat() ; 

hdc_cmd.hs = 0; 
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line[O] = 0; /* null terminated */ 
while(1) /* forever (see F1i0) */ 
1 
line[O] = get_fkey() ; /* get a function key for menu selection */ 
switch(line[0o]) /* determine menu selection */ 
{ 
case F1: /* recalibrate */ 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds] .spt; 
hdc_cmd.sn = QO; 
hdc_issue(CMD_REST) ; 
wait_hdc() ; /* wait for command complete */ 
break; 


case F2: /* head select + 1 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn = 0; 
if (hdc_cmd.hs < hdd[hdc_cmd.ds].hc) hdc_cmd.hs++; 
if (hdc_cmd.hs == hdd[hdc_cmd.ds].hec) hdc cmd.hs--; 
hdc_issue(CMD_SEEK) ; 
wait_hdc() ; /* wait for command complete 


“e. 


¢ f 


break; 


case F3: /* head select -1 */ 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn = 0; 
if (hdc_cmd.hs) hdc_cmd.hs--; 
hdc_issue(CMD_SEEK) -; 
wait _hdc() ; /* wait for command complete */ 
break; 


case F4: /* seek + 1 cylinder */ 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[{hdc_cmd.ds]. spt; 
hdc_cmd.sn = Q; 
if (hde_cmd.cyl < hdd[hdc_cmd.ds].cc) hdc_cmd.cyl+t; 
hdc_issue(CMD_SEEK) ; 
wait_hdc() ; /* wait for command complete */ 
break; 
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case F5: /* seek - 1 cylinder » 


hdc_cmd.ecm = SDH_ECC; 

hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 

hdc_cmd.sn = Q; 

if (hdce_cmd.cyl) hdc_cmd.cyl--; 

hdc_issue(CMD_SEEK) ; 

wait_hdc(); /* wait for command complete 
break; 


case F6: /* scan id 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = 1; 
for(i = 1; i <= hdd{hdc_cmd.ds].spt; i++) 
{ 
hdc_cmd.sn = i; 
hdc_issue(CMD_SCAN) ; 
wait_hdc() ; /* wait for command complete 
} 


break; 


case F7: /* hard format disk * 


hdc_issue(CMD_REST) ; 


i 


cei wait_hdc(); /* wait for command complete * 
interleave(hdc_buff, 256, 17, 2, Oxffff): 
for(cyl = 0; cyl < hdd[hdc_cmd.ds].cc; cyl++) /* all cylinders 
! 


hdc emda. cyl = cyl; /* current cylinder * 
for(head = 0; head < hdd[hdc_cmd.ds].hc; head++)/* all heads * 


{ 
hdc_cmd.hs = head; 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hdc_cmd.sn = OQ; 
hdc_issue(CMD_SEEK) ; /* seek to current cylinder 
wait_hdc(); /* wait for command complete 
hdc_cmd.ecm = SDH_ECC; 
hdc_cmd.sc = hdd[hdc_cmd.ds].spt; 
hde_cmd.sn = 0; 
hdc_issue(CMD_FRMAT) ; 
while(!(inp(&phdc->csr) & STAT_DRQ)) 
for(i = 0: i < 256; i++) 
outw(&phdc->sec_buf, hdc_buff[i]); 
wait_hdc(); /* wait for command complete 


break; 


* f 


ef 


*/ 
*/ 


«/ 
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case F8: 


interleave(hdc_buff, 256, 


{ 
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17,. 2, Oxtft2); 
for(cyl = 0, head = 0; head < 30; headt+t) 


sprintf(oline, "/%04x ", hdc_buff[head]); 


disp_str(13 + (head / 10), 


} 


break; 


case F10: 
return; 


dsp_hdc_stat() 


sf 


HDC_RESULT *pres = &hdc_result; 
char oline[50]: 


| 


sprintf(oline, "Error Reg 
disp_str(21, 1, oline); 
sprintf(oline, "Sector Count 
disp_str(21, 41, oline); 


sprintf(oline, "Sector Number: 


disp_str(22, 1, oline); 
sprintf(oline, "Cylinder Num 
disp_str(22, 41, oline); 
sprintf(oline, "SDH Register 
disp_str(23, 1, oline); 
sprintf(oline, "Status Reg 
disp_str(23, 41, oline); 
sprintf(oline, "Last command 
disp_str(24, 1, oline); 


(head % 10) * 5, oline); 


/* return to caller (main menu) */ 


Ox%02x" 
0x%,02x" 
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Ox%04x" 
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pres~>error) ; 
pres->sc) ; 
pres~>sn) ; 
pres->cyl); 
pres->sdh) ; 
pres->status) ; 


hdc_cmd.last_cmd) ; 
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interleave(pb, size, cnt, il, £111) 


int *pb; /* pointer to buffer */ 
int size; /* size of buffer */ 
int cnt; /* number of sectors */ 
int il; /* interleave:1 */ 


int fill; /* fill byte */ 


int *pi; /* temp pointer */ 
int *pf; /* start of fill */ 
int x, y; /* temp counter */ 
x = size - cnt; /* £111 size */ 
pf = pi = pb + cnt; /* offset to fill */ 
while(x--) *pit+ = fill; /* set fill bytes */ 


for(x = 1; x <= cnt; x++) 
{ 
if(pi > pf) pi = pbt+; 
*pitt+ = x << 8; 
For(y = Ay-y thy yet? parts 


} 
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Chapter 13 
Network Hardware Interface 


Introduction to the LANCE 


The network hardware interface is located on the VAXmate workstation I/O 
board. When the back of the VAXmate workstation is open and no options are 
plugged in, the I/O board is visible. 


VAXmate workstations may contain different versions of the LANCE, which 
exhibit subtle differences on large networks with high levels of traffic. The dif- 
ferent versions of hardware require special treatment by software. Digital 
Equipment Corporation recommends that you avoid programming the hardware 
interface directly. Instead, applications should use the MS-Network session 
level interface, DECnet-DOS session level interface, and the Data Link inter- 
face to access the network. For additionl information about these software in- 
terfaces, see Chapter 18 in this manual. 


The remainder of this chapter discusses the following topics: 
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nae 


Functional description of the Network Hardware Interface 
Programming sequence 

Register descriptions 

Physical description 

Physical address field 

Logical address filter field 

Buffer management 

Receive descriptor rings 

Transmit descriptor ring's 

Network interface external interconnect 
Network Interface system bus interconnect 


Additional Source of Information 


Additional information about the LANCE can be found in the 
Advanced Micro Devices document: 


¢ MOS Microprocessors and Peripherals 1985 Data Book 


Functional Description of the Network 
Hardware Interface 


The network hardware interface is connected to the system bus. The interface 
contains address, data, and control lines capable of handling the controller func- 
tions. The interface is part of the standard communications and I/O functions 
of the VAXmate workstation. 


The Network Interface (NI) consists of three main integrated circuits. The 
hardware also includes a small number of discrete components, system bus in- 
terfacing devices, and a female BNC connector mounted directly on VAXmate 
I/O module printed circuit board. The BNC connector connects the Network 
Interface to the network. 


The three integrated circuits in the NI are the: 
¢ Coax Transceiver Interface (CTI} 
e Serial Interface Adapter (SIA) 
e Local Area Network Controller for Ethernet (LANCE) 


The Alea Transceiver nbestace 


tr ansmit, receive, ane ollision Asie fine tions on ‘the erate cies ‘The 
CTI is electrically isolated from the other devices as required by IEEE 802.3 
specifications. 


The Serial Interface Adapter 


The SIA interfaces to the CTI through an isolation transformer. The SIA per- 
forms manchester phase encoding and decoding of the data transferred over 
the network. The SIA also interfaces with the LANCE. The SIA filters noise 
and interprets collisions for the LANCE circuit. 


The Local Area Network Controller 


The LANCE converts data beteen the network serial format and the system 
byte-wide format. The LANCE is the primary interface between the network 
hardware and the rest of the VAXmate workstation. 
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In receive mode, the LANCE: 


1. Receives information from the SIA. 


2. Converts the serial network bit stream into a parallel (8-bit wide) byte 
stream. 


3. Strips the Ethernet preamble and synchronization pattern. 
4, Checks and removes the CRC bits. 


5. Uses direct memory access and a 24-bit-wide physical address to place 
the information in memory located in the CPU address space. 


In transmit mode, the LANCE: 


1. Uses DMA to read data from system memory. 

2. Converts the data to a serial bit stream. 

3. Adds a preamble and sync pattern. 

4. Calculates and adds the CRC at the end of the data packet. 


5. Passes the data packet to the SIA for transmission on the ThinWire 
Ethernet. 


Programming the LANCE 


tures that are used to program the hardware interface. 


The LANCE is controlled by a set of four control and status registers (CSRs) 
and three data structures. The CSRs are accessible within the CPU I/O address 
space and the data structures located in the CPU memory address space. After 
the LANCE is enabled, it acquires additional operating parameters by accessing 
the data structures. The LANCE accesses system memory through bus arbitra- 
tion between the LANCE, CPU, memory refresh controller, and the DMA 
controller. 


After the LANCE is programmed, it independently manages the data struc- 
tures and transfers data packets on the ThinWire Ethernet. 


The three data structures accessed by the LANCE are: 


Initialization Block 
Receive and Transmit Descriptor Rings 
Data Buffers 


= 
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Initialization Block 


The initialization block is 12 contiguous words of memory starting on a word 
boundary. The controlling program stores the operating parameters in the in- 
itialization block. To acquire the operating parameters, which are necessary for 
device operation, the LANCE reads the initialization block. The initialization 
block contains the: 


* Mode of Operation 

Physical Address 

Logical Address Mask 

Location of Receive and Transmit Descriptor Rings 

Number of Entries in Receive and Transmit Descriptor Ring's 


&¢& & @ @ 
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Receive and Transmit Descriptor Rings 

The receive and transmit descriptor rings are two ring structures: one for in- 
words, and must start on a quadword boundary. The descriptor rings contain 
the buffer address, length, and status. 


Data Buffers 


Data buffers are contiguous portions of memory reserved for buffering packets. 
Data buffers can begin on arbitrary byte boundaries. Entries in the Receive and 
Transmit Descriptor Rings point to the data buffers. 


Programming Sequence 


The general programming sequence of the LANCE is: 


1. Load CSR1 and CSR2, which identifies the location of an initialization 

block in memory. 

2. Load CSR3, which sets the operating mode of the LANCE. 

3. Set the INIT and STRT bits in CSRO, which causes the LANCE to 
load the information from the initialization block and to access the 
descriptor rings. 


NOTE 

The ThinWire Ethernet interface conforms to the IEEE 802.3 
specification, which requires a frequency accuracy of +0.01%. 
The crystal oscillator in the VAXmate network hardware re- 
quires 1 Ms after power on to achieve +10% accuracy, and 10 
seconds to achieve +0.01% accuracy. Therefore, the network in- 
terface is considered operational 10 seconds after power-on of 
the VAXmate workstation. 


On powerup, the VAXmate diagnostics ensure the required 10 
second settling time. 
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Register Description 


“Wl The Network Interface uses three physical I/O ports as registers: two in the 
LANCE, and one in the interface logic. The registers in the LANCE comprise 
five logical registers, for a total of six logical registers in the Network Interface 
(NI). 


The LANCE internal CSRs are accessed through its two bus addressable ports, 
a register address port (RAP), and a register data port (RDP). The internal 
CSRs are read (or written) in a two step operation. The address of the CSR is 
written into the address port (RAP). Then the data is read from (or written 
into) the selected CSR through the RDP. Once written, the address in RAP 
remains unchanged until rewritten. 


Table 13-1 describes the registers and their addressing. 


Table 13-1 Network Interface Registers 
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Primary Alias R/W Register Description 

VO 1/O Width 

Address Address 

OC60H C064H R/W 16-bit LANCE Register Data 
Port (RDP) 

0C62H CO66H R/W 16-bit LANCE Register Address 
Port satis P i 

RAP = 0 R/W 16-bit LANC 

RAP = 1 R/W 16-bit LANC. 

RA! R/W 16-bit LAN 

RAP = 3 R/W 16-bit LANCE Cs 

0C68H O0C69H- scence Ww 8-bit NI oo 
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The logical address is the contents of RAP bits 1-0, and applies to references 
to LANCE internal CSR registers 3-0. These registers are physically addressed 
at LANCE sed marae on the Miele 1/O bus, and individually se- 


The VAXmate address decode logic creates alias I/O port addresses for certain 
registers. The alias I/O addresses are listed in Table 13-1. 


NOTE 
Because future revisions of hardware may not implement these 
aliases, programs should not use the alias addresses. 
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Register Data Port (RDP) 


4 3 2 


CSR DATA 
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Bit R/W_ Description 
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15-0 R CSR DATA 


Writing data into RDP writes the data into the CSR selected in 
RAP. Reading the data from RDP reads the data from the CSR 
selected in RAP. CSR1, CSR2, and CSR3 are accessible only when 
the STOP bit of CSR0O is set. 

If the STOP bit is not set while attempting to access CSR1. 
CSR2, or CSR3, the LANCE returns READY, but a read opera- 
tion returns undefined data and a write operation is ignored. 
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Register Address Port (RAP) 
Lo 14 13 12 11 


7 6 > 4 3 


RES 


Bit R/W_ Description 


‘iano 


15-2 RES - Reserved (always 0) 


1-0 R/W_ CSR - Control/Status Register Select 
= CSRO accessed through RDP 
1 = CSR1 accessed through RDP 
2 = CSR2 accessed through RDP 
3 = CSR3 accessed through RDP 


ieee neonates Aeon inhouse oni niaeeiioneMtUDnapoy 


The register address port is cleared by STOP or Bus RESET. 
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Control And Status Register 0 (RAP = 0} 


Bit 


15 


R/W 


14 1 12 11 10 9 8 


So inser enna 


Description 
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ERR - Error 

Q = The four bits BABL, CERR, MISS and MERR are all equal 
to 0. 

1 = One or more of the four bits, BABL, CERR, MISS, or 
MERR are equal to 1. 

BABL - Babble 

0 = Less than 1519 bytes of data have been transmitted. 

1 = 1519 bytes of data, or more, have been transmitted. 


buffer byte count equals 
zero, The LANCE assumes the Ethernet transmission is limited by 
the physical channel interface. 

If INEA = 1, an interrupt is generated when BABL is set. 


0 = No effect 
1 = Clears this bit 


Bable is read/clear only. BABLE is cleared by Bus RESET or set- 


ting the STOP bit. 


Bit R/W 
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Description (CSRO - cont.) 


CERR - Collision Error 
Q = No collision error 
1 = Collision error 


The collision input failed to activate within 2 us after a 
transmission, started by the controller, was completed. Collision 
after transmission is a test feature of the transceiver. 


0 = No effect 
1 = Clears this bit 


CERR is READ/CLEAR ONLY 
CERR is cleared by Bus RESET or setting the STOP bit. 


MISS - Missed Packet 
0 = Receiver owns a receive buffer or the SILO has not 


overflowed 

1 = The receiver loses a packet because it does not own a receive 
buffer and the SILO has overflowed, indicating loss of data. 
SILO overflow is not reported because there is no receive 


ring entry in which to write the status. 


0 = No effect 
1 = Clears the bit 


If INEA equals 1 and MISS equals 1, an interrupt is generated. 


MISS is READ/CLEAR ONLY. MISS is cleared by Bus RESET 
or setting the STOP bit. 


MERR - Memory Error 
0 = No memory error 
= LANCE is the Bus Master and has not received READY 
within 25.6 us after asserting the address on the DAL lines. 
When a Memory Error is detected, the receiver and 
transmitter are turned off and an interrupt is generated if 
INEA = 1. 


0 = No effect 
1 = Clears the bit 


MERR is READ/CLEAR ONLY. MERR is cleared by Bus RESET 
or setting the STOP bit. 


13-9 


Bit R/W 
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Description (CSRO - cont.) 
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RINT - Receiver Interrupt 
0 = No receiver interrupt 
1 = Receiver interrupt 

Q = No effect 

1 = Clears the bit 


RINT = 1 when the status for an entry in the Receive Descriptor 


If INEA = 1, an interrupt is generated when RINT is set. 


RINT is READ/CLEAR ONLY 
RINT is cleared by Bus RESET or setting the STOP bit. 


TINT - Transmitter Interrupt 

Q = No transmitter interrupt 

1 = When the status for an entry in the Transmit Descriptor 
Ring is updated. 

0 = No effect 

1 = Clears the bit 

If INEA = 1, an interrupt is generated when TINT is set. 

TINT is READ/CLEAR ONLY 

TINT is cleared by Bus RESET or setting the STOP bit. 

IDON - Initialization Done 

0 = Initialization procedure not completed 

1 = LANCE has completed the initialization procedure started by 
setting the INIT bit. When IDON is set, the LANCE has 


read the initialization block from memory and stored the new 
parameters. 


If INEA = 1, an interrupt is generated when IDON is set. 
IDON is READ/CLEAR ONLY 


0 = No effect 
1 = Clears the bit 


IDON is cleared by Bus RESET or setting the STOP bit. 


INTR - Interrupt Flag 

0 = BABL, MISS, MERR, RINT, TINT, and IDON are all equal 
0 

1 = One or more of the following interrupt causing conditions 
has occurred: BABL, MISS, MERR, RINT, TINT, IDON. If 
INEA =1 and INTR =1 the INTR L I/O pin will be low. 


INTR is cleared by Bus RESET or setting the STOP bit. INTR is 
also cleared by clearing the conditions that caused the interrupt. 


Bit R/W 


6 R/W 

o R 

4 R 

3 WwW : 
R 
Ww 


Description (CSRO - cont.) 


INEA - Interrupt Enable 

0 = The INTR L I/O pin will be high, regardless of the state of 
INTR. 

1 = If INTR =1, the INTR L I/O pin will be low. 


INEA allows the INTR L I/O pin to be driven low when the 


RXON - Receiver ON 
0 = Receiver disabled 
1 = Receiver enabled 


RXON = 0 when IDON = 1, if DRX = 1 in the MODE register 
or a memory error (MERR =1) has occurred. RXON = 1 when 
STRT is set in CSRO, if DRX O in the MODE field of the initiali- 
zation block is IDON = 1. 


RXON is cleared by Bus RESET or setting the STOP bit. 


TXON - Transmitter On 
Q = Transmitter enabled 
1 = Transmitter disabled 


When TXON = 0, IDON = 1, and DTX = 1 in the MODE regis- 
ter, an Underflow or Retry error has occurred during transmission 
or a memory error (MERR) has occurred. 


TXON = 1 when the INIT bit = 1, and when STRT =1 if DTX 


‘DMD - Transmit Demand 

0 = The packet is sent subject to the 1.6-millisecond polling in- 
terval delay. 

1 = Packet is transmitted without the typical delay of the polling 

interval, 1.6 milliseconds. 


Q = No effect 
1= Clears this bit 


TDMD, when set, causes the LANCE to access the Transmit 
Descriptor Ring without waiting for the poll time interval to 
elapse. TDMD need not be set to transmit a packet, it merely 
hastens the LANCE response to a Transmit Descriptor Ring entry 
insertion by the software. 


TDMD is cleared by Bus RESET or setting the STOP bit. TDMD 
is cleared by the LANCE after the Transmit Descriptor Ring is 
accessed. 


Bit R/W 
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- R/W 


id R/W 


0 R/W 
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STOP 


Q = No effect 

1 = LANCE disabled from all external activity and internal logic 
cleared 

STOP set is the equivalent of asserting Bus RESET L. The 

LANCE remains inactive and STOP remains set until the STRT or 

INIT bit is set. If STRT, INIT, and STOP are all set together, 

STOP will override the other bits and only STOP will be set. Stop 

will terminate all LANCE activities asynchronously. 

STOP is cleared by setting INIT or STRT. 

STRT - Start 


STRT enables the LANCE to send and receive packets, perform 
direct memory access and do buffer management. Setting STRT 
clears the STOP bit. If STRT and INIT are set together, the INIT 
function will be executed first. 


STRT is READ/WRITE WITH ONE ONLY. Writing a 0 into this 
bit has no effect. 
STRT is cleared by Bus RESET or setting the STOP bit. 


INIT - Initialize 
)= No effect 
= Starts LANCE initialization and reads initialization block. 
Setting INIT clears the STOP bit. 
If STRT and INIT are set together, the INIT function will be exe- 
cuted first. 


INIT is Sitaias by Bus RESET or setting the STOP bit. 
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Control And Status Register 1 (RAP = 1) 
15 14 13 12 11 10 9 8 


TADR(15-8) 
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Bit Description 
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15-1 IADR 


The low-order 16 bits of the address of the first word (lowest ad- 
dress) in the initialization block. 


0 Always 0 
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Accessible only when the STOP bit of CSRO equals 1. If STOP = 0, an access 
returns READY, a Read operation returns undefined data and a Write opera- 
tion is ignored. CSR1 is unaffected by Bus RESET L., 
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Control And Status Register 2 (RAP = 2) 
15 14 13 12 11 10 9 8 
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IADR (Bits 23-16) 
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Bit Description 


Reserved. 
7-0 IADR (Bits 23-16) 


The high order 8 bits of the address of the first word of the in- 
itialization block. 
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Accessible only when STOP equals 1 (CSRO). If STOP = 0, an access returns 
READY, a Read operation returns undefined data and a Write operation is 
ignored. 


CSR2 is unaffected by Bus RESET L. 


13- 14 


Control And Status Register 3 (RAP = 3) 


15 14 13 Zz 11 10 9 8 
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RES BSWP 
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Bit R/W_ Description 


15-3 RES - Reserved (Always 0) 

2 R/W BSWP - Byte Swap 
0 = The LANCE does not swap high and low bytes 
1 = The LANCE swaps the high and low bytes on DMA data 

transfers between the SILO and bus memory. 

BSWP allows the LANCE to operate in systems that consider bits 
15-8 to be the least significant byte and bits 7-0 to be the most 
significant byte. Only data from Silo transfers is swapped, the in- 
itialization block data and the Ring Descriptor entries are NOT 
swapped. BSWP is cleared by Bus RESET or setting the STOP bit 
in CSRO. 


1 R/W ACON - ALE Control 


R/iW 0 = ALE is asserted high. 
1 = ALE is asserted low. 


ACON defines the assertive state of ALE when the LANCE is a 
Bus Master. 


ACON is cleared by Bus RESET or setting the STOP bit in 
CSRO. 
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Bit R/W Description (CSR3 - cont.) 
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0 R/W BCON - Byte Control 
BCON I/O Pin 16 VO Pin 15 VO Pin 17 


0 BM 1L BM 0 L HOLD L 
i BUSAKO L BYTE H BUSRQ L 


BCON redefines the Byte Mask and Hold I/O pins. 
BCON is cleared by Bus RESET or setting the STOP bit in 
CSRO. 
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Table 13-2 lists the value required for each function for CSR3. 
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Bit Ranevion Value Ragitted 
15-3 Undefined should be zero 
2 BSWP (Byte Swap) 0 
1 ACON (ALE Control) 1 
0 BCON eye meee oe ) Q) 


CSR3, which allows redefinition of the bus master interface, contains three 
bits. They are used to customize certain hardware interface signals provided by 
the LANCE when it is in bus master mode. The programming of these bits is 
hardware implementation dependent. The VAXmate workstation values are in 
Table 13-2 


Accessible only when the STOP bit of CSRO equals 1. If STOP = 0, an access 
returns READY, a Read operation returns undefined data and a Write opera- 
tion is ignored. 


Bus RESET L or setting the STOP bit in CSRO, clears CSR3. 
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NI CSR (0C68H) 
7 6 5 4 3 2 1 0 
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a LED SET - Diagnostic LED Indicator Set 
W O= No effect 
1 = LED on 


6 RES - Reserved (undefined) 


5 RES - Reserved (undefined) 
4 LED CLEAR - Diagnostic LED Indicator Clear 
WwW 0 = No effect 
1 = LED off (Power-on default) 
3 INT CLEAR - Network Interface Interrupt Enable Clear 
W 0 = No effect 
1 = Disable interrupts (Power-on default} 
2 RES - Reserved (undefined) 
1 RES - Reserved (undefined) 


0 INT SET - Network Interface Interrupt Enable Set 
Ww Q = No effect 


1 = Enable interrupts 


The NI CSR supports individual bit-set and bit-clear capability in a write-only 
register. Writing a 1 to a bit invokes its particular set or clear operation on the 
designated function. Writing a 0 to a bit does not invoke the particular set or 
clear operation for the designated function. Writing 0 to both set and clear bits 
for a designated function leaves the state of that function unchanged. Because 
writing 1 to both the set and clear bits of a designated function will toggle the 
state of that function, writing 1 to both the set and clear bits is not 
recommended. 


Initialization Block 


During initialization, the LANCE reads operating parameters from the initiali- 
zation block. 


When the INIT bit in CSRO is set, the LANCE begins reading the initialization 
block. To ensure proper parameter initialization and LANCE operation, the 
controlling program should set the INIT bit and then set the STRT bit. After 
the LANCE reads the initialization block, the LANCE sets IDON in CSRO and 


if INEA equals 1, the LANCE also generates an interrupt. 


Higher Addresses TLEN- TDRA (2 3. 16) IADR +22 
TDRA (15-00) IADR +20 

RLEN-RDRA (23-16) IADR +18 

RDRA (15-00) IADR +16 

LADRF (63-48) IADR +14 

LADRF (47-32) IADR +12 

LADREF (31-16) IADR +10 

LADRF (15-00) IADR +08 

PADR (47-32) IADR +06 

PADR (31-16) IADR +04 

PADR (15-00) IADR +02 

Base Address of Block napede ee) IADR +00 


The base address, BASE ADDR, is formed from CSR2 bits 7-0 and CSRI1 bits 
15-1. 
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Mode Field 
(Initialization Block, Offset 00H) 


14 13 12 11 10 9 8 
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RES 


2 1 0 


Bit Description 
15 PROM - Promiscuous 
= Incoming packets matching physical or logical address filter 
are accepted. 
1 = All incoming packets are accepted. 


14-7 RES - Reserved 
INTL - Internal Loopback 


INTL is used with the LOOP (bit 2) to determine where the loop- 
back is to be done. Internal loopback allows the LANCE to receive 
its own transmitted packet. The maximum transmit packet size al- 
lowed during loopback is 32 data bytes. The LANCE automatically 
adds 4 bytes of CRC to the packet if DTCRC=0 and therefore the 
receive packet could be 36 bytes. INTL is only valid if LOOP = 1, 
otherwise it is ignored. 

INTL Loop LOOPBACK 

x 0) No loopback, normal operation 

0 1 external 

1 1 internal 


23 
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Description (Mode Field - cont.) 
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DRTY - Disable Retry 

0 = LANCE attempts 15 retransmissions of a packet after the 
first collision before reporting a Retry error. 

1= LANCE attempts only one transmission of a packet. If there 
is a collision on the first transmission attempt, a Retry Error 
(RTRY) is reported in Transmit Message Descriptor 3 
(TM D3). 


COLL - Force Collision 

0= = Collision not forced 

1 Collision forced during subsequent transmission attempt 
C 

t. 


-OLL allows the collision logic to be tested. For COLL to be valid, 
she oni must be in internal loopback mode. When COLL = 1, 
16 transmissions are attempted, and a retry error is reported in 
T MDS. 


DTCR - Disable Transmit CRC 

Q = The transmitter generates and appends a CRC to the 
transmitted packet. 

1 = The CRC logic is allocated to the receiver and no CRC is 
generated and sent with the transmitted packet. 


During loopback, DTCR = 0 generates a CRC on the transmitted 
sanae CRC logic, shared by the receiver and the transmitter, 

cannot generate and check CRC at the same time. Therefore, the 
receiver does the CRC check. The generated CRC and data are 
written into memory and can be checked by the software. 


If DTCR = 1 during loopback, the software must append a CRC 


value to the transmit data in the transmit buffer. The receiver 
checks the CRC on the received data and reports any errors. 


Bit pe eras (Mode Pig: - cont. ‘i 


2 LOOP - Loopback 
Q = LANCE operates in normal mode 
1 = LANCE operates in full duplex mode for test purposes 


LOOP allows the LANCE to operate in full duplex loopback mode 
for test purposes. The maximum transmit packet size is limited to 
32 data bytes. The received packet may be 36 bytes because the 
LANCE automatically adds 4 CRC bytes if DTCRC=0. 


During loopback, the runt packet filter is disabled because the 
maximum packet is forced to be smaller than the minimum size 
Ethernet packet of 64 Bytes. 


LOOP = 1 allows simultaneous transmission and reception for a 
message constrained to fit within the SILO. The LANCE waits 
until the entire message i is in the SILO before serial transmission 
begins. The incoming data stream fills the SILO from behind as it 
is being emptied. Moving the received message out of the SILO to 
memory does not begin until reception has ceased. In loopback 
mode, transmit data chaining is not possible. Receive data chaining 
is allowed, regardless of the receive buffer length. In normal opera- 
ees not Fearne the ee buffers must be at least 64 bytes 


1 DTX - Disable the Transmitter 
0 = LANCE can access the Transmit Descriptor Ring 
1 = LANCE does not access the Transmit Descriptor Ring, 
therefore no transmissions are attempted. DTX = 1 clears 
the TXON bit in CSRO when initialization is complete. 


0 DRX - Disable the Receiver 
0 = Receives inc oming packets 
1 = LANCE rejects incoming packets and does not access the 


Receive Descriptor Ring. DRX = 1 clears the RXON bit in 
CSRO pi initialization is complete. 
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The Mode field allows alteration of the LANCE operating parameters. In 
normal operation, the Mode Register clear. 


Physical Address Field 

(Initialization Block, Offset 02H) 

PADR, the Network Physical Address, is the unique 48-bit physical address 
assigned to the LANCE. PADR(0) must be zero. 


Logical Address Filter Field 
(Initialization Block, Offset 08H) 


LADRF, the Logical Address Filter Field, is a 64-bit mask used by LANCE to 
accept the logical addresses. 


The Logical Address Filter is a 64-bit mask that accepts incoming Logical 
Addresses sent through the CRC circuit. After all 48 bits of the address have 
travelled through the CRC circuit, the high-order 6 bits of the resultant CRC 
are strobed into a register. This register selects one of the 64-bit positions in 
the Logical Address Filter. If the selected filter bit equals 1, the address is 
accepted and the packet is put in memory. The first bit of the incoming ad- 
dress must be 1 for a logical address. If the first bit is 0, it is a physical ad- 
dress and is compared against the physical address that was loaded through 
the Initialization Block. 


The Broadcast address, which is all ones, does not go through the Logical 
Address Filter and is always enabled. If the Logical Address Filter is loaded 
with all zeros, all incoming logical addresses except Broadcast are rejected. 


Receive Descriptor Ring Pointer Field 
(Initialization Block, Offset 10H) 


31 30 29 28 27 26 25 24 
a ———— | 
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RDRA 
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RDRA 
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RDRA 


0 0 0 


Bit 
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31-29 


28-24 
23-0 
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Description nenene Peer semis ee Field) 
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RLEN - RE CEIV E RI NG LEN GTH 
The number of entries in the Receive Ring expressed as a power 
of two. 

RLEN 

Number of Entries 


0) I 
1 2 
Z 4 
3 8 
A 16 
3D 32 
6 64 
7 128 


RES (Reserved) 
RDRA - Receive Descriptor Ring Address 


RDRA is the base address (lowest address) of the receive descrip- 
tor ring. Because the receive rings must be aligned on quadword 
boundaries, bits 2-0 must be zeros. 
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Transmit Descriptor Ring Pointer Field 
(Initialization Block, Offset 14H) 
a 30 29 28 a 26 25 24 
a ep eee 


TLEN RES 
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TDRA 


nS ene LeeeeNe eet See eee: Meee ket eee Me Seieeene att SM ener 
7 6 6. 4 3 Z 1 0 
$$$] re Ocoee SO Oe eer 


TDRA 
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Bit Description (Transmit Descriptor Ring Pointer Field) 
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31-29 TLEN 


TLEN is the number of entries in the Transmit Ring’ expressed 
as a power of two. 
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Number of 


TLEN Entries 
0 1 
ps 4 
3 8 
4 16 
5 32 
6 64 
7 128 
8 256 

28-24 RES - Reserved 

23-0 TDRA - Transmit Descriptor Ring Address 


TDRA is the base address (lowest address) of the Transmit 
Descriptor Ring. Because the transmit rings must be aligned on 
quadword boundaries, these bits 2-0 must be zeros. 
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Buffer Management 


Buffer descriptors, organized as ring structures in memory, are used for buffer 
management. The buffer descriptors, also called message descriptors, are four 
words long and point to a buffer. Two ring structures are allocated for the 
LANCE: a ring of receive message descriptors (RMDs) and a ring of transmit 
message descriptors (TMDs). To transmit or receive packets, the LANCE polls 
each ring structure. The LANCE also enters status information in the descrip- 
tor entry. The LANCE is limited to looking only one descriptor entry ahead of 
the one with which the LANCE is currently working. 


The location of the descriptor rings and their length are found in the initializa- 
tion block, which the LANCE accesses during the initialization procedure. 
Writing a 1 into the STRT bit of CSRO causes the LANCE to start accessing 
the descriptor rings and enables the sending and receiving of data packets. 


The LANCE communicates with the data link layer program through the ring 
structures in memory. Each entry in the ring is owned either by the LANCE 
or the data link layer program. The ownership bit (OWN) in the message 
descriptor entry determines who owns the entry. Therefore, ownership of a 
descriptor entry is mutual exclusive. To gain ownership of a descriptor entry, 
the communications partner (LANCE or data link layer program) must wait 
until the owner gives ownership to the communications partner. Between the 
time a communications partner relinquishes ownership of a descriptor entry and 
the time that communications partner regains ownership, it must not change 
any data in the descriptor entry. 
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Descriptor Rings in Memory 


Figure 13-1 shows receive and transmit descriptor rings with 128 message 
descriptors each. 


anaemia enMe tint casenniaueinnibieemesini niet 


Higher 


Addresses TMD( 127) 


TMD(1) 


tec ainsi MDSHA dMASIODraesiniilegnac >in 


Base Address | 
of TMD(O) 
Transmit Ring Pan 


OBZxH DP HAH ENS we 


Higher 
Addresses RMD(127) 


sine tannin en nnNdeaninn Hin aotionKaPieoneAaninnein 


RMD(1) 


Pewiyoennunnenansrniisiseeinmtniianneeuntnanininsesiostorteeitdetn ener eeieitinden amnesia Mbit NRO 


Qt 5 Als wo wz 


Base Address 
of 
Receive Ring 


RMD(0) 


somata tots tone GMeeteni nici ateinsaitliiibiomdivadinngant 


Figure 13-1 Descriptor Rings 


Receive Descriptor Rings 


Each descriptor in a ring in memory is a 4 word entry. The format of the 
receive descriptor follows. 


Receive Message Descriptor 0 (RMD0O) 
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Bit Description 
15-0 LADR - Low Order Address 


The LADR of the buffer pointed to by this descriptor. LADR is 
written by the software and unchanged by the LANCE. This is the 
memory location to place the next received message. 
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Receive Message Descriptor 1 (RMD1) 
15 41 
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Bit Description 


15 OWN 
Q = Descriptor entry owned by the data link layer software 
1 = Descriptor entry owned by the LANCE 


The LANCE clears the OWN bit after filling the buffer pointed to 

by the descriptor entry. The software sets the OWN bit after 

emptying the buffer. Once the LANCE or software has relin- 

quished ownership of a buffer, it may not change any field in the 

four words that comprise the descriptor entry. 

14 ERR - Error 

0 = The four bits, FRAM, OFLO, CRC or BUFF, are all equal to 
zero. 

1 = One or more of the four bits, FRAM, OFLO, CRC or BUFF, 
is equal to one. 


ERR is set by the LANCE and cleared by the software. 

13 FRAM - Framing Error 
0 = No framing error 
1 = The incoming packet contained a non integer multiple of 

eight bits and there was a CRC error. 

A CRC error on the incoming packet is a necessary condition for 
FRAM to equal 1 (even if there was a non integer multiple of eight 
bits in the packet). FRAM is set by the LANCE and cleared by 
the software. 
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Bit eiiikasiecheis (RMDI - cont.) 
12 OFLO - Overflow Error 
0 = No overflow error 
1 = The receiver has lost all or part of the incoming packet be- 
cause it cannot store the packet in a memory buffer before 
the internal SILO has overflowed. 


OFLO is set by the LANCE and cleared by the software. 
11 CRC - Cyclic Redundancy Check 


0 = No CRC error 
1 = The receiver detected a CRC error on the incoming packet. 


CRC is set by the LANCE and cleared by the software. 
10 BUFF - Buffer Error 
0 = No buffer error 
1 = The LANCE does not own the next buffer while data chain- 
ing a received packet. This condition could occur if the OWN 
bit of the next buffer was zero or the LANCE could not ac- 
quire the next status before silo overflow occurred. 


BUFF is set by the LANCE and cleared by the software. 


STP - Start of Packet 

0 = This is not the first buffer the LANCE uses for this packet. 

1 = This is the first buffer LANCE uses for this packet. It is 
used for data chaining buffers. 


STP is set by the LANCE and cleared by the software. 


8 ENP - End of Packet 
Q = This is last buffer LANCE uses for this packet. 
1= This’! is the last eek es ie the LANCE for this packet. It 


Both STP and ENP set aise that the packet fit into one buffer 
and there was no data chaining. ENP is set by the LANCE and 
cleared by the software. 

7-0 HADR - High Order 8 Address Bits 


The HADR of the buffer pointed to by this descriptor. This field is 
written by the software and unchanged by the LANCE. 
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Receive Message Descriptor 2 (RMD2) 
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Bit Description 
15-12 Must be ones. This field is written by the software and unchanged 
by the LANCE. 
11-0 BCNT - Buffer Byte Count 
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BCNT is the length of the buffer pointed to by this descriptor ex- 

pressed as a two's complement number. This field is written by the 
software and unchanged by the LANCE. The minimum buffer size 

is 64 bytes. 
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Receive Message Descriptor 3 (RMD3) 
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RES MCNT 
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Bit Description 
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15-12 RES 
Reserved and read as zeros. 
11-0 MCNT - Message Byte Count 


MCNT is the length in bytes of the received message. MCNT is 
valid only when ERR is clear and ENP is set. MCNT is written by 
the LANCE and cleared by the software. When data chaining, 
RMD3 is only loaded by the LANCE when the status of last buffer 
is updated. Only the status word is updated for the other buffers 
in the data chain. 
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Transmit Descriptor Ring 


transmit descriptor follows. 


Transmit Message Descriptor 0 (TMD0) 


15 14 a4 LZ 11 10 9 8 
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rq yy eyesore 


LADR 
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Bit Description 
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15-0 LADR - Low Order 16 Address Bits 


The LADR of the buffer pointed to by this descriptor. LADR is 
written by the software and unchanged by the LANCE. 
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Transmit Message Descriptor 1 (TMD1) 
; : 3 : 11 


3 
i: eee: eae) Se 


HADR 
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Bit Description 
15 OWN 
0 = Owned by the LANCE 
1 = Owned by the data link layer software 


OWN indicates whether the descriptor entry is owned by the soft- 
ware (OWN = 0) or by the LANCE (OWN = 1). The software sets 
the OWN bit after filling the buffer pointed to by this descriptor. 
The LANCE clears the OWN bit after transmitting the contents of 
the buffer. Neither the software nor the LANCE may alter a 
descriptor entry after relinquishing ownership. 


14 ERR - Error Summary 
Q = All of LCOL, LCAR, UFLO., and RTRY equal 0. 
1 = One or more of LCOL, LCAR, UFLO, or RTRY equal 1. 


ERR is set by the LANCE and cleared by the software. 


13 RES- Reserved (Always 0) 
12 MORE 


0 = One retry or less was needed to transmit a packet. 
1 = More than one retry was needed to transmit a packet. 


MORE is set by the LANCE and cleared by the software. 


Bit Description (TMD1 - cont.) 
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11 ONE 
Q = The number of retries need to transmit a packet is not equal 
ii 
1 = Exactly one retry was needed to transmit a packet. 


ONE is set by the LANCE and cleared by the software. 


10 DEF - Deferred 
0 = The channel is ready for LANCE to transmit a packet. 
1 = The channel is busy when the LANCE is ready to transmit a 
packet. 


DEF set by the LANCE and cleared by the software. 
9 STP - Start of Packet 
0 = Not the first buffer LANCE uses for this packet. 
1 = The first buffer to be used by the LANCE for this packet. It 
is used for data chaining buffers. 
STP is set by the software and unchanged by the LANCE. 


8 ENP - End of Packet 
0 = Not the last buffer LANCE uses for this packet 
1 = The last buffer to be used by the LANCE for this packet. It 
is used for data chaining buffers. 
If both STP and ENP are set, the packet fit into one buffer and 


there was no data chaining. ENP is set by the software and un- 
changed by the LANCE. 


7-0 HADR - High-Order 8 Address Bits 


HADR is the high-order 8 address bits of the buffer pointed to by 
this descriptor. HADR is written by the software and unchanged 
by the LANCE. 
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Transmit ee — 2 (TMD2) 
11 10 9 8 
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BCNT 
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Bit Description 
15-12 Always 1. This field is set by the software and unchanged by the 
LANCE. 


11-0 BCNT - Buffer Byte Count 
BCNT is the number of bytes LANCE transmits of the buffer to 
which TMD2 points. BCNT is expressed in 2’s complement. 


BCNT is written by the software and not affected by the LANCE. 
The minimum size of the buffer is 64 bytes. 
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Message Descriptor 3 (TMD3) 


14 


13 
t2 
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BUFF - Buffer Error 

Q = No buffer error 

1 = LANCE, during transmission, does not find the ENP flag in 
the current buffer and does not own the next buffer. BUFF 
= 1 also if the LANCE owns the next buffer but can not 
read the next buffer’s status parameters before the silo un- 
derflowed. 


BUFF is set by the LANCE and cleared by the software. If a 
Buffer Error occurs, an Underflow Error also occurs because the 
transmitter continues to read data from the silo until empty. 


UFLO - Underflow Error 
Q = No underflow error 
= The transmitter has truncated a message due to lack of data 

from memory. UFLO indicates that the Silo has emptied 
before the end of the packet was reached. 

UFLO is set by the LANCE and cleared by the software. 

RES - Reserved (Always 0) 

LCOL - Late Collision 

0 = Nocollision 

1 = A collision occurred after the slot time of the channel has 
elapsed. 


The LANCE does not retry on late collisions. LCOL is set by the 
LANCE and cleared by the software. 


Bit 
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BA 


10 


9-0 


Description (TMD3 - cont.) 
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LCAR - Loss of Carrier 

0 = RENA does not go false during transmission 

1 = The carrier presence (RENA) input to the LANCE goes false 
during a transmission initiated by the LANCE. The LANCE 
does not retry upon Loss of Carrier. 


LCAR is set by the LANCE and cleared by the software. 


RTRY - Retry Error 
Q = No retry error 
= The transmitter has failed in 16 attempts to transmit a 
message due to repeated collisions on the medium. If DRTY 
= 1 in the MODE register, RTRY sets after 1 failed 
transmission attempt. 
RTRY is set by the LANCE and cleared by the software. 


TDR - Time Domain Reflectometry 


The TDR shows the state of an internal LANCE counter that 
counts from the start of a transmission to the occurrence of a colli- 
sion. This value is useful in determining the approximate distance 
to a cable fault. The TDR value is written by the LANCE and is 
valid only if RTRY is set. 
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TMD3 is valid only if the LANCE has already set the ERR bit of TMD1. 
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Network Interface External Interconnect 


The VAXmate network hardware connects to the network coaxial cable through 
a BNC T-connector. The VAXmate network hardware complies with IEEE 
802.3 LOBASE2 specifications. The cable shield is isolated from the VAXmate 
logic and chassis ground, and must be externally grounded by the interconnect 
equipment, The VAXmate workstation does not contain a 50-ohm line- 
termination, The 50-ohm line terminator must be supplied externally, as re- 
quired by the connection topology. 


Network Interface System Bus Interconnect 


The hardware interface uses the 16-bit and 8-bit system bus for data transfers. 
It operates in both bus master and bus slave modes. In bus slave mode, the 
registers respond to I/O cycles. The LANCE registers require 16-bit I/O and 
the NI CSR register requires an 8-bit I/O. All of the network interface registers 
are located in proprietary I/O address space of the VAXmate workstation. 
Accessing the LANCE registers can cause extra I/O wait states. 


In the bus master mode, the LANCE initiates 16-bit memory cycles to transfer 
data, commands and parameters to and from main system memory. The 
VAXmate workstation supports both 16-bit and 8-bit memory cycles, but the 
network interface supports only 16-bit memory cycles. Although the VAXmate 
uses the READY signal to support asynchronous memory cycles, the network 
interface supports only synchronous memory cycles. The network interface per- 
forms DMA transfers at the rate of 600 ns per cycle. 


The network hardware works with standard system memory resident on the 
VAXmate CPU module, and with the VAXmate memory option located in the 
workstation main box. Accesses to 8-bit memory in the VAXmate expansion 
box are not supported by the network hardware. If the memory complies with 
the network hardware timing requirements, third-party 16-bit memory in the 
expansion box may work correctly. 


The interface does not support DMA to the VAXmate video display memory. 
The interface uses the full 24-bit physical memory address space and operates 
with physical addresses only 


* 
ag 


The network hardware uses interrupt line IRQ10, and a special LAN DMA 
request line, provided by the CPU Module. The special LAN DMA request line 
has higher priority than all DRQs lines on the system bus. 
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DMA controller 4-5 
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ROM BIOS and 14-8 
self-tests 14-8 
Fixed disk register 12-25 
Fixed priority 
DMA controller 4-5 
Floppy disk interrupt 15-7 
Flow control for LAT 18-58 
FlushComm 17-65 
Focus 
changing for repeating key 17-11 
FONT 16-15 
Font file structure 
FONT.COM 16-17 
GRAFTABL.COM 16-18 


Font files 
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loading 16-19 
Font RAM 
accessing 7-9 
color map support function 15-31 
functions 15-31 
programming 7-9 
Font sizes 
terminal emulation 17-73 
FONT COM 
affect on KEYB.COM 16-16 
affect on SORT.EXE 16-16 
font file structure 16-17 
Fonts 
description 16-16 
Format track 15-66 
command 12-17 
function 15-47 
diskette drive controller 
register sets 11-24 
Functional description of network 
hardware interface 13-2 
Functions 
datalink 18-11 
interrupt vector A-12 
LAT 18-64 
retrieving characters from a ring 
buffer A-16 
session 18-91 
DIGITAL-specific 18-118 
storing characters in a ring buffer 


A-16 
support for example programs 
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GDI 17-2 
printer support 17-83 

Get 
Country Code Function 16-3 
current date and time for SMB 
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MS-DOS OEM Number Function 
16-3 
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Get/Set Table Pointer 17-78 
GetCommError 17-66 
GetCommEventMask 17-65 
setCommState 17-65 
GetLatService 17-71 
GetLatStatus 17-69 
GetMessage 17-4 
GRAFTABL 16-16 
GRAFTABL.COM 

font file structure 16-18 
Graphics 

character table pointer interrupt 

15-145 

device interface 17-2 

format memory maps 7-10 

mode 7-10 
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Hangup for session 18-108 

Hard disk 
boot block, DIGITAL 15-134 
interrupt 15-151 
parameter tables interrupt 15-146 
reset function 15-53 
types 16-13 


Hard disk controller 
alternate status register 12-25 
command register 12-10 
cylinder number high register 12-8 
cylinder number low register 12-8 
data register 12-3 
DIGITAL input register 12-26 
error register 12-5 
features 12-1 
fixed disk register 12-25 
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programming example 12-27 

read sector command 12-13 

read verify command 12-19 

registers 12-1 

restore command 12-11 

SDH register 12-9 

sector count register 12-7 

sector interleave 12-18 

sector number register 12-7 

seek command 12-12 

set parameters command 12-22 

status register 12-23 
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12-4 

write sector command 12-15 


Hard reset 14-13 


causes 14-13 
shutdown byte 14-13 


Hardware 


extended self-test 14-10 
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retriggable one-shot 6-4 
starting with Ctrl/Alt/Del 14-12 
system tests at startup 14-1 
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available (IRQ15) 15-151 
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floppy disk 15-7 

hard disk 15-151 

keyboard 15-5 

local area network controller 
(LANCE) interrupt 15-149 
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nonmaskable interrupt 15-3, 15-76 


real-time clock 15-148 


redirect to interrupt OAH 15-148 


serial printer port 15-150 
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Idle cycle 
DMA controller 4-3 


IEEE 802.3 specification 13-2, 13-4 
10BASE2 specifications 13-40 


[logical keyboard messages 17-12 
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Include files 
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ring buffer control structure A-11 
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device is busy 15-98 

diskette 
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parameter tables 15-59 
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15-31 

format a track 15-47, 15-66 
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initialize 


Index Ill] 


12 


asynchronous port 15-72 
diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
printer 15-125 
interrupt completion handler 15-98 
keyboard input 15-109 
keyboard state 15-110 
keyboard status 15-109 
move a block of memory 15-93 
open device 15-89 
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character and attribute at 
cursor position 15-19 
current video state 15-27 
cursor position 15-14 
long 15-50 
long 256 byte sector 15-58 
one or more disk sectors 15-44 
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pixel 15-24 
real-time clock 15-137 
system clock 15-136 
recalibrate drive 15-55 
receive character 15-74 
return 
asynchronous port status 15-75 
change line status 15-68 
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drive type 15-57, 15-67 
printer status 15-126 
RTC date 15-138 
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status code of last I/O request 
15-43, 15-62 
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service system request key 15-91 
set 
a wait interval 15-90 
alarm 15-139 
color palette 15-22 
cursor position 15-13 
cursor type 15-12 
page 15-16 
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RTC date 15-139 
system clock 15-136 
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test drive ready 15-54 
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verify one or more disk sectors 
15-46 
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15-65 
wait (no return to user) 15-92 
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15-21 
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hard disk 15-151 
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keyboard break 15-141 
nonmaskable interrupt 15-3, 15-76 
print screen 15-4 

read configuration 15-35 
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real-time clock 15-148 
redirect to interrupt OAH 15-148 
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serial printer port 15-150 C 11-15 

timer tick 15-141 command 11-7 

video parameters 15-142 D 11-17 


Industry-standard interrupts with DTL 11-16 
DIGITAL extensions b OT I 1 " | 6 
asynchronous communications GPL 11-16 
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COM 1/serial 15-6 oo 
COM2/modem 15-6 Non 11 ? 17 
disk input/output (I/O) 15-38 PCN 11-17 
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keyboard 15-5 srt/hut ] 1-14 _ 
keyboard input 15-101 status register 0 11-9 | 
printer output 15-123 status register : I1- 10 
video input/output 15-8 status register 2 11-12 
time-of-day 15-135 status register 3 11-13 
, STP 11-17 
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Installing ene cn anne) counter and 
ANSLSYS 16-5 speaker mode 6-4 
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23 a 6A 18-64 
INT 12H support 17-82 6D 18-11 
INT 15H support 17-83 Interrupt 21H 
Interface function 30H 16-3 
signals, monitor 7-44 function 38H 16-3 
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Invalid commands 

keyboard-interface controller com- 

mand codes 8-23 


Invoke self-test command 10-3 


Joystick support function 15-91 


Jumpers 
processor board testing 14-14 


Kernel 17-2 
Key buffering notification enabled 
15-113 

Key combinations 15-107 
break 15-108 
extended self-test 15-108 
pause 15-108 
print screen 15-108 
system request key 15-107 
system reset 15-107 

Key mapping's 
LK250 17-13 

Key notification 17-77 
enabled 15-112 
function 15-111 


KEYB.COM. 16-1 
how affected i 7 ONT.COM 16-16 


Keyboard 
break interrupt 15-141 
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buffer interface 8-1 
buffer function 15-115 
driver 17-2 

illogical messages 17-12 
input function 15-109 
input interrupt 15-101 
interface lines 8-12 
interrupt 15-5 
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layout, LK250 15-103 
LEDs 17-4 
LK250 17-2, 8-1 
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map tables 

creating 16-22 
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scan codes 15-104 
setting user preferences 17-6 
state function 15-110 
status function 15-109 
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Keyboard extensions 
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DecSetAutorep 17-7 
DecSetClickVol 17-7 
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DecSetLockState 17-6 
DecSetNumlockMode 17-10 
enable/disable autorepeat 17-6 
return keyboard nationality 17-6 
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Keyboard handling 
inside a window 17-75 
outside a window 17-78 

Keyboard mode 
lock 8-25 
toggling 17-4 
unlock 8-25 


Keyboard remapping 16-19 
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command byte bit definitions 8-10 
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disable autorepeat 8-24 
disable key scanning and restore 
to defaults 8-28 
echo 8-26 
enable autorepeat 8-24 
enable key scanning 8-28 
enter DIGITAL extended scan 
code mode 8-23 
exit DIGITAL extended scan 
code mode 8-23 
invalid commands 8-23 
keyboard mode lock 8-25 
keyboard mode unlock 8-25 
LEDs on/off 8-26 
request keyboard id 8-23 
resend 8-29 
reserved 8-25, 8-26, 8-29 
reset 8-29 
reset keyboard led 8-24 
restore to defaults 8-26 
set autorepeat delay and rate 
8-27 
set keyboard led 8-23 
set keyclick volume 8-24 
command register 8-5, 8-9 
commands 8-9 
data registers 8-5 
diagnostics 8-4 
disable keyboard 8-12 
enable keyboard 8-12 
error handling 8-14 
interface test 8-12 
keyboard responses 
acknowledge 8-31 
buffer overrun 8-30 
echo 8-30 
release prefix 8-31 
resend 8-31 
self-test failure 8-31 
self-test success 8-30 
physical interface 
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read port 1 8-12 
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self-test 8-12 
status register 8-6 
write port 2 8-13 
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edit 17-3 
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broadcast address 13-22 

buffer descriptors, see LANCE 
message descriptors 13-27 

buffer management 13-17 

control and status registers 13-3 
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CRC 13-22 

CSRO 13-5, 13-6, 13-7, 13-8, 13-18 

CSRO-CSR3 13-5 

CSRI1 13-4, 13-5, 13-6, 13-7, 13-13 

CSR2 13-4, 13-5, 13-6, 13-7, 13-14 

CSR3 13-4, 13-6, 13-7, 13-15 

CSRs 13-5 
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data chaining 13-27 

data structures 13-3 

descriptor entry 13-27 

descriptor rings 13-4 

Ethernet data stream 13-27 

initialization block 13-3, 13-18, 
13-27 
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base address 13-18 
mode 13-19 
logical address filter field 13-22 
logical address mask 13-4 
message descriptors 13-27 
mode of operation 13-4 
physical address field 13-19 
physical address mask 13-4 
polling 13-27 
programming 13-3 
programming sequence 13-4 
receive and transmit descriptor 
rings 13-3, 13-4, 13-28 
location of 13-4 
number of entries 13-4 
receive descriptor ring pointer 
field 13-23, 13-24 
receive descriptor rings 
receive message descriptor lL, 
rmd1 13-30, 13-27 
receive mode 13-3 


register data port 13-5, 13-6 
RMD2 13-32 
RMD3 13-33 
status register 13-3 
TMDO 13-34 
TMD1 13-35 
TMD2 13-37 
TMD3 13-38 
transmit 
descriptor ring pointer 13-25 
message descriptors 13-27 
mode 13-3 
LANCE - see Local Area Network 
Controller 13-2 
LANCE interrupt 15-149 
LAT 
/D switch 18-55 
/G switch 18-56 
/R switch 18-56 
call-back routine 18-58, 18-60 
closing a session 18-58 
command line 18-555 
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custom application interface 17-66 
data exchange 18-58 
flow control 18-58 
functions 18-64 
close session 18-67 
get next service name 18-70 
get status 18-65 
open session 18-66 
read data 18-68 
send break signal 18-72 
send data 18-69 
service table reset 18-71 
overview 18-54 
program example 18-73 
service directory 18-56 
session control block 18-59 
session start 18-57 
session status word 18-63 
slots 18-57 
LAT control blocks 17-62 
LAT functions 
CloseLat 17-68 
GetLatService 17-71 
GetLatStatus 17-69 
InquireLatServices 17-70 
OpenLat 17-67 
ReadLat 17-68 
SendLatBreak 17-70 
WriteLat 17-69 
LAT support 17-62 
Latches, divisor 9-15 
LCB 17-62 
number available 17-62 
LCOUNTRY 16-27 
file structure 16-27 
LEDs 17-4 
automatic control 15-108 
color indications 14-8 
during powerup test 14-8 
I/O board 14-8 
memory board option 14-8 
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keyboard-interface controller com- 


mand codes 8-26 
Line 
control register 9-7 
LAT state change call-back 18-9 
status interrupt 9-10 
status register 9-11 
Listen for session 18-107 
LK250 keyboard 8-1, 17-2 
command codes 8-22 
control functions 8-3 
error handling 8-31 
key mappings 17-13 
layout 15-103 
logical interface 8-2 
pass-through mode 8-2 
physical interface 8-2 
programming example 8-46 
responses 8-30 
buffer overrun 8-30 
echo 8-30 
release prefix 8-31 
resend 8-31 
self-test failure 8-31 


see LAT 18-54 
Loop services 18-42 
Loopbacks 
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Maintenance operations protocol 
console server identify self 18-42 
loop services 18-42 
network boot request 18-43 
remote read counters 18-43 

Mapping 
asynch serial comm devices to 

LAT services 17-62 
character position 7-7 
input/output 2-4 
interrupt address 2-6 
memory 2-3 
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sizing 
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during extended self-test 14-10 
without initializing 14-12 
use in real mode 14-8 
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scan codes 8-15 three-channel counter and speaker 
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values 8-17 

translated but not used 8-21 
system powerup 8-2 
translate mode &-2 
U.S. and foreign legends 8-31 


Loadable device drivers 
ANSLSYS 16-5 


Loading font files 16-19 


Local area network controller 13-2 
(LANCE) interrupt 15-149 
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Messages 
illogical keyboard 17-12 
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2 10-11 
Mode-dependent values 
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status interrupt 9-10 vendor reserved function command 
status register 9-13 10-3 
Monitor Mouse reports 
interface signals 7-44 position (byte 1) 10-4 
specifications 7-44 position (byte 2) 10-5 
MOP 18-42 position (byte 3) 10-5 
start and send system ID 18-45 self-test (byte 1) 10-6 | 
stop 18-45 | self-test (byte 2) 10-6, 10-7 
Mouse 10-1, 17-61 ee test ee 3) 10-7 : 
asynchronous serial interface 10-2 Move a block of memory 15-93 
baud rates 10-2, 10-11 Movement 10-3 
button position 10-3 MS-DOS Date and Time Structure 
commands (table) 10-2 16-3. 16-4 
communication 10-2 eae ke 
data bytes 10-2 MS-Network . 
encoders 10-1 compatible session services 18-92 
extended self-test loopback test session level interface 13-1 
serial ports 14-10 MS-Windows 
incremental stream mode com- applications programming inter- 
mand 10-3 face 17-2 
invoke self-test command 10-3 entry points 
movement 10-3 AnsiToOem 17-55 
port interrupt 15-150 OemToAnsi 17-58 
position 10-3 _ Mulicast address 
programming example 10-14 ennhie 18-91 
prompt mode command 10-3 disable 18-22 


reports 10-4 — 10-7 


sks | format 18-7 
request mouse position command 


10-3 Multiplex messages 18-6 
self-test 10-3 
serial interface 10-2, 10-8 N 


command register 10-12 
mode register 1 10-10 


om Name status for session 18-103 
mode register 2 10-11 


status register 10-9 Network = 
serial interface registers 10-8 addressing 18-90 — 
transmit holding register and boot request 18-36, 18-43 
receive butter 10-8 hardware interface 13-1 
Signetics interconnect. CSR 13-17 
SCN2261 enhanced Network interface 13-2 
programmable communications CSR 13-5 
interface 10-2, 10-8 external interconnect 13-40 
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physical I/O ports 13-5 

register description 13-5 

system bus interconnect 13-40 
Network software 18-1 

components 18-2 

datalink 18-5 

overview 18-2 
NI - see Network Interface 13-2 
NI CSR 13-40 
No return to user function 15-92 
Nonmaskable interrupt 15-3, 15-76 
Normal keyboard functions 

fetch next character input from 

keyboard 17-75 

return current shift status 17-76 

test for character available 17-75 
Not supported functions 

joystick support 15-91 
Numeric keypad 17-3 
Numlock 

toggling numeric keypad 17-3 
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OemToAnsi 17-58 
Open 
datalink portal 18-17 
device function 15-89 
LAT session 18-66 
OpenComm 17-63 
OpenLat 17-67 
Operational states 
diskette drive controller 11-18 
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Parallel 
bit stream, converted by LANCE 
13-3 


port retry function 15-131 
Parameters 
disk 16-14 
Pass-through mode 
keyboard 8-2 
Peripheral interrupt controller 
initializing 3-24 
Pointer 
diskette parameter tables 15-143 
graphics character table pointer 
15-145 
hard disk parameter tables 15-146 
video parameters 15-142 
Poll command 3-17 
Port driver 18-5 
Portal 
close 18-21 
defined 18-5 
read list 18-29 
read status 18-30 
Powerup test 14-1, 14-8 
LEDs 14-8 
RAM checks 14-8 
self-test error codes 14-8, 14-10 
sequence 14-1 
Print screen 15-4 
Printer 
connector signals 9-20 
extended self-test loopback test 
14-10 
GDI support 17-83 
output interrupt 15-123 
to Host mode C-12 
type function 15-129 
Priorities 
DMA controller 4-5 
rotation 3-13 
Processor board 
testing 14-14 


Processor modes 
real mode 14-8 
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Programming 
diskette drive controller 11-18 
Programming examples 
counter and speaker 6-20 
datalink 18-46 
diskette drive controller 11-27 
DMA controller 4-15 
constant values 4-15 
data structures 4-17 
disabling DMA channel 4-22 
initializing 4-18 
opening DMA channel 4-19 
preparing DMA channel 4-20 
interrupt controllers 3-21 
LAT 18-73 
LK250 keyboard 8-46 
mouse 10-14 
real-time clock 5-15 
three-channel counter/timer 6-16 
UART (8250A) 9-22 
video controller 7-45 
modem control 9-17 


Prompt mode command 10-3 


Pulse output port command 
keyboard-interface controller 8-13 
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RAM 
system 
powerup test checks 14-8 


Rate generator 6-5 


Read 
channel status for datalink 18-27 
character and attribute at cursor 

position function 15-19 

command 8-10 
configuration interrupt 15-35 
current video state function 15-27 
cursor position function 15-14 
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data command 11-21 

data for LAT 18-68 

datalink counters 18-32 

DECparm string address 18-39 

deleted data command 11-22 

id command 11-23 

light-pen position function 15-15 

long 256 byte sector 15-58 

long function 15-50 

node entry given index for session 
18-125 

node entry given node name for 
session 18-124 

node entry given node number for 
session 18-123 

one or more disk sectors function 
15-44 

one or more track sectors 15-63 

pixel function 15-24 

port 1 command 8-12 

port 2 command 8-12 

portal list for datalink 18-29 

portal status for datalink 18-30 

real-time clock function 15-137 

sector command 12-13 

system clock function 15-136 

test inputs command 8-13 

track command 11-23 

verify command 12-19 
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three-channel counter and speaker 
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ReadComm 17-64 
ReadLat 17-68 
Real mode 14-8 


Real-time clock 
address map 5-3 
addressing 5-2 
alarm registers 5-12 
automatic alarm c belie oy 12 
avoiding update cycles 5-13 
battery backup source 52 
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data register ranges 5-11 
data registers 5-10 
extended self-test 14-10 
features 5-1 
interrupts 5-14 
programming example 5-15 
register A 5-4 
register B 5-6 
register C 5-8 
register D 5-9 
registers 5-3 
update cycle 5-13 
Real-time clock interrupt 15-148 
Recalibrate command 
diskette drive controller 
register sets 11-26 


Recalibrate drive function 15-55 


Receive 
any for session 18-112 
broadcast for session 18-117 
buffer/transmitter holding register 
9-3 
character function 15-74 
datagram for session 18-115 
for datalink 18-10 
for session 18-111 
message descriptor, see RMD 
13-29 
Redirect 
parallel printer function 15-127 
to interrupt OAH interrupt 15-148 
Redirector 18-84 
Register sets 
format track command 11-24 
read data command 11-21 
read deleted data command 11-22 
read id command 11-23 
read track command 11-23 
recalibrate command 11-26 
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seek command 11-27 
sense drive status command 11-27 
sense interrupt status command 
11-26 
specify command 11-26 
write data command 11-21 
write deleted data command 11-22 
Registers 
8250A UART 9-2 
diskette drive controller 11-2 
eels 
change 11-6 
control 11-3 
D 11-17 
data 11-5 
data transfer rate 11-6 
DTL 11-16 
EOT 11-16 
GPL 11-16 
H 11-15 
head/unit select 11-8 
hit/nd 11-15 
internal 11-7 
main status 11-4 
N 11-16 
NCN 11-17 
PCN 11-17 
R 11-15 
SC 11-16 
srt/hut 11-14 
status register 0 11 
status register 1 11- 
status register 2 11- 
status register 3 11 
STP 11-17 
DMA controller 4-7 
base and current address 4-7 
base and current word 4-8 
command 4-9 
mode 4-12 
request 4-13 
status 4-14 
temporary 4-14 
interrupt enable 9-4 
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interrupt identification 9-6 
keyboard-interface command 8-9 
keyboard-interface controller 
command 8-5 
data 8-5 
status 8-6 
line control 9-7 
line status 9-11 
modem control 9-9 
modem status 9-13 
receive buffer/transmitter holding 
9-3 
special purpose 9-18 
three-channel counter and speaker 
6-8 
control 6-11 
system 6-9 
video controller 
color select 7-39 
control register A 7-41 
control register B 7-43 
status 7-37, 7-38 
write data 7-39 


Release prefix 
LK250 keyboard responses 8-31 
Remapping 
keyboard 16-19 
Remote read counters 18-43 
Repeating key 
changing focus 17-11 
Request 
line, DMA 13-40 
mouse position command 10-3 
register 4-13 
transmit buffer for datalink 18-25 
Request keyboard id 17-78 
function 15-118 
keyboard-interface controller com- 
mand codes 8-23 
Resend 
keyboard-interface controller com- 
mand codes 8-29 
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Reserved 
keyboard-interface controller com- 
mand codes 8-25, 8-26, 8-29 
Reset 
for session 18-98 
keyboard-interface controller com- 
mand codes 8-29 
keyboard led 
keyboard-interface controller 
command codes 8-24 
mode function 16-11 
processor 14-13 
Restore command 12-11 
Restore to defaults 
keyboard-interface controller com- 
mand codes 8-28 
Result state 
diskette drive controller 11-20 


Return 
asynchronous port status function 
15-75 


change line status function 15-68 

current drive parameters function 
15-48 

current shift status flag 17-76 

days-since-read counter function 
15-140 

DIGITAL configuration word 
15-99 

drive type function 15-57, 15-67 

keyboard nationality 17-6 


function 15-95 
memory size interrupt 15-37 
printer status function 15-126 
RTC date function 15-138 
status code of last I/O request 
15-62, 15-43 


Return codes 
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datalink 18-12 
session 18-93 


Revector of interrupt 13H interrupt 
15-145 


RMD0O 13-29 
ROM BIOS 


available (IRQ15) interrupt 15-151 

basic interrupt 15-132 

bootstrap interrupt 15-133 

clock tick interrupt 15-5 

COM 1/serial interrupt 15-6 

COM2/modem interrupt 15-6 

during soft reset 14-12 

firmware diagnostics and 14-8 

initialization procedure 14-12 

loading operating system 14-12 

local area network controller 
(LANCE) interrupt 15-149 

mouse port interrupt 15-150 

nonmaskable interrupt 15-3, 15-76 

print screen interrupt 15-4 

read configuration interrupt 15-35 

real-time clock interrupt 15-148 

redirect to interrupt OAH inter- 
rupt 15-148 

return memory size interrupt 
15-37 

revector of interrupt 13H interrupt 
15-145 

RTC alarm interrupt 15-148 

serial printer port interrupt 15-150 


ROM BIOS 80287 error interrupt 


15-151 


ROM BIOS asynchronous communi- 


cations interrupt 15-70 

extended mode 15-77 

initialize asynchronous port func- 
tion 15-72 

receive character 15-74 

retry on timeout error 15-86 

return asynchronous port status 
15-75 

send break 15-84 


set baud rate 15-87 
set modem control 15-85 
transmit character 15-73 


ROM BIOS cassette input/output in- 


terrupt 15-88 

begin virtual mode 15-96 

close device 15-89 

device is busy 15-98 

interrupt completion handler 15-98 

joystick support 15-91 

move a block of memory 15-93 

open device 15-89 

return DIGITAL configuration 
word 15-99 

return memory size above one 
megabyte 15-95 

service system request key 15-91 

set a wait interval 15-90 

termination 15-90 

wait (no return to user) 15-92 


ROM BIOS disk I/O interrupt 15-38 


diskette errors 15-59 
diskette functions 15-59 
diskette parameter tables 15-59 
execute controller internal diag- 
nostics 15-56 
format track 15-47, 15-66 
hard disk 
errors 15-40 
functions 15-40 
parameter tables 15-41 
reset function 15-53 
initialize 
diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
read long 256 byte sector 15-58 
read long 15-50 
read one or more disk sectors 15- 
44 
read one or more track sectors 15- 
63 
recalibrate drive 15-55 
return change line status 15-68 
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return current drive parameters 
15-48 

return drive type 15-57, 15-67 

return status ie of last I/O 
request 15-43, 15-62 

seek to specific cylinder 15-52 

set drive and media type for 
format 15-69 

test drive ready 15-54 

verify one or more disk sectors 15- 


46 
verify one or more track sectors 
15-65 


write long 15-51 
write one or more disk sectors 15- 


45 
write one or more track sectors 
15-64 
ROM BIOS diskette 
errors 15-59 


functions 15-59 
parameter tables 15-59 
interrupt 15-143 
ROM BIOS floppy disk interrupt 
15-7 
ROM BIOS graphics character table 
pointer interrupt 15-145 


ROM BIOS hard disk 
interrupt 15-151 
parameter tables interrupt 15-146 
ROM BIOS initialization procedure 
14-12 
ROM BIOS interrupt 
02H 15-3, 15-76 
05H 15-4 
O8H 15-5 
O9H 15-5 
OBH 15-6 
OCH 15- . 
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QEH 15 
11H 15- 35 
12H 15-37 
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18H 15-132 
19H 15-133 


1BH 15-141 
1CH 15- 14] 
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LEH 15-143 


40H 15 -145 

41H 15-146 

46H 15-146 

4AH 15-148 

70H 15-148 

71H 15-148 

72H 15-149 

73H 15-150 

74H 15-150 

75H 15-151 

76H 15-161 

77H 16-151 

ROM BIOS Interrupt 10H 15-8 

enable/disable 256 character 
graphic font 15-30 

font RAM and color map support 
15-31 

read character and attribute at 
cursor position 15-19 

read current video state 15-27 

read cursor position 15-14 

read light-pen position 15-15 

read pixel 15-24 

scroll active page down 15-17 

scroll active page up 15-17 

set color palette 15-22 

set cursor position 15-13 

set cursor type 15-12 

set page 15-16 

set video mode 15-10 

TTY write string 15-28 

write character and attribute at 
cursor position 15-20 

write character at cursor position 
15-21 

write character using terminal 
emulation 15-25 
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write pixel 15-23 


ROM BIOS interrupt 13H 15-38 
diskette errors 15-59 
diskette functions 15-59 
diskette parameter tables 15-59 
execute controller internal diag- 
nostics 15-56 
format a track 15-47, 15-66 
hard disk 
errors 15-40 
functions 15-40 
parameter tables 15-4] 
reset 15-53 
initialize 
diskette subsystem 15-61 
drive characteristics 15-49 
entire disk subsystem 15-42 
read long 256 byte sector 15-58 
read long 15-50 
read one or more disk sectors 
15-44 
read one or more track sectors 
15-63 
recalibrate drive 15-55 
return 
change line status 15-68 


current drive parameters 15-48 


drive type 15-57, 15-67 


status code of last I/O request 


15-43, 15-62 

seek to specific cylinder 15-52 

set drive and media type for 
format 15-69 

test drive ready 15-54 

verify one or more disk sectors 
15-46 


verify one or more track sectors 


15-65 

write long 15-51 

write one or more disk sectors 
15-45 

write one or more track sectors 
15-64 


ROM BIOS interrupt 14H 15-70 


extended mode 15-77 

initialize asynchronous port 15-72 

receive character 15-74 

retry on timeout error 15-86 

return asynchronous port status 
15-75 

send break 15-84 

set baud rate 15-87 

set modem control 15-85 

transmit character 15-73 


ROM BIOS interrupt 15H 15-88 


begin virtual mode 15-96 

close device 15-89 

device is busy 15-98 

interrupt completion handler 15-98 

joystick support 15-91 

move a block of memory 15-93 

open device 15-89 

return digital configuration word 
15-99 

return memory size above one 
megabyte 15-95 

service system request key 15-91 

set a wait interval 15-90 

termination 15-90 

wait (no return to user) 15-92 


ROM BIOS interrupt 16H 15-101 


character count 15-114 
extended codes and functions 
15-116 
key notification 15-111 
keyboard buffer 15-115 
keyboard input 15-109 
keyboard state 15-110 
keyboard status 15-109 
keyboard table pointers 15-120 
request keyboard ID 15-118 
send to keyboard 15-119 


ROM BIOS interrupt 17H 15-123 


initialize printer 15-125 
parallel port retry 15-131 
printer type 15-129 

redirect parallel printer 15-127 
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return printer status 15-126 return days-since-read counter 
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living set system clock 15-136 
days-since-read counter 15-140 ROM BIOS timer tick interrupt 


RTC date 15-138 15-141 


set alarm 15-139 7 ROM BIOS video 
set real-time clock 15-138 modes 15-10 


set RTC date 15-139 parameters interrupt 15-142 


set system clock 15-136 eee eae os | 
we cue k a ROM BIOS video input/output inter- 
ROM BIOS interrupt vectors 15-1, rupt 15-8 


15-2 enable/disable 256 character 
ROM BIOS keyboard graphic font 15-30 


break interrupt 15-141 

input interrupt 15-101 

interrupt 15-5 
character count 15-114 
extended codes and functions 
15-116 
keyboard buffer 15-115 
keyboard input 15-109 
keyboard notification 15-111 
keyboard state 15-110 
keyboard status 15-109 
keyboard table pointers 15-120 
request keyboard ID 15-118 
send to keyboard 15-119 


ROM BIOS printer output interrupt 


15-123 
initialize printer 15-125 
parallel port retry 15-131 
printer type 15-129 
redirect parallel printer 15-127 
return printer status 15-126 
transmit character 15-124 


ROM BIOS time-of-day interrupt 


15-135 
cancel alarm 15-140 
read real-time clock 15-137 
read system clock 15-136 
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font RAM and color map support 
15-31 

functions 15-9 

read character and attribute at 
cursor position 15-19 

read current video state 15-27 

read cursor position 15-14 

read light-pen position 15-15 

read pixel 15-24 

scroll active page down 15-17 

scroll active page up 15-17 

set color palette 15-22 

set cursor position 15-13 

set cursor type 15-12 

set page 15-16 

set video mode 15-10 

tty write string 15-28 

write character and attribute at 
cursor position 15-20 

write character at position 15-21 

write character using terminal 
emulation 15-25 

write pixel 15-23 


ROM diagnostics 14-1. 14-8 


extended self-test 14-10 
powerup test 14-1, 14-8 


Rotating priority 


DMA controller 4-5 
RTC alarm interrupt 15-148 
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Scan codes 15-102 
LK250 keyboard 8-15, 8-17 
translated but not used 8-21 
Scan equal command 
diskette drive controller 
register sets 11-24 
Scan high or equal command 
diskette drive controller 
register sets 11-25 
Scan low or equal command 
diskette drive controller 
register sets 11-25 
Scroll active page down function 15- 
17 
Scroll active page up function 15-17 
SDH register 12-9 
Sector 
count register 12-7 
interleave 12-18 
number register 12-7 
Seek command 12-12 
diskette drive controller 
register sets 11-27 
Seek to specific cylinder 15-52 
Select 
compose processing 17-6 
numlock processing 17-6 
Self-test command 
keyboard-interface controller 8-12 
Self-test failure 
LK250 keyboard responses 8-31 
Self-test success 
LK250 keyboard responses 8-30 
Send 


broadcast for session 18-116 
data for LAT 18-69 
datagram for session 18-114 
double for session 18-110 
for session 18-109 


Send break function 15-84 
Send to keyboard function 15-119 
SendLatBreak 17-70 
Sense 
drive status 11-27 
interrupt status 11-26 
Serial 
data 9-1 
printer port interrupt 15-150 
bit stream, converted by LANCE 
13-3 
interface adapter 13-2, 13-3 


Service 

directory 18-56 

table reset for LAT 18-71 

system request key function 15-91 

Session 

start for LAT 18-57 

status word 18-63 

for LAT 18-57 

asynchronous notification routine 
18-90 

asynchronous requests 18-89 

functions 18-91 
add a node 18-120 
add name 18-101 
call 18-105 
cancel 18-97 
check for presence 18-96 
delete all node entries 18-126 
delete entry given node name 
18-122 
delete entry given node number 
18-121 
delete name 18-102 
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DIGITAL function check 18-119 
DIGITAL-specific 18-118 
hangup 18-108 

listen 18-107 

name status 18-103 

read node entry given index 
18-125 


name 18-124 
read node entry given node 
number 18-123 
receive 18-111 
receive any 18-112 
receive broadcast 18-117 
receive datagram 18-115 
reset 18-98 
send 18-109 
send broadcast 18-116 
send datagram 18-114 
send double 18-110 
status 18-99 
MS-Network compatible services 
18-92 
network addressing’ 18-90 
overview 18-83 
return codes 18-93 
status buffer 18-100 
synchronous requests 18-89 


Session control block (SCB) 18-85 


fields 18-86 
for LAT 18-59 


Set 


a wait interval function 15-90 
alarm function 15-139 
autorepeat delay and rate 8-27 
baud rate function 15-87 
color palette function 15-22 
country code function 16-3 
cursor position function 15-13 
cursor type function 
Mode-dependent values 15-12 
DECparm string address 18-40 
drive and media type for format 
function 15-69 
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graphics rendition function 16-8 
keyboard led 8-23 

keyclick volume 8-24 

mode function 16-10 

modem control function 15-85 
page function 15-16 
parameters command 12-22 
real-time clock function 15-138 
RTC date function 15-139 
system clock function 15-136 
video mode function 15-10 


SetCommBreak 17-65 


SetCommState 17-65 


Shift key 
affect on numeric keypad 17-3 


SIA - See Serial Interface Adapter 
13-2 
Signals 
communications connector 9-19 
modem connector 9-21 
printer connector 9-20 
Signetics 
SCN2261 enhanced programmable 
communications interface 10-2, 
10-8 


DMA controller 4-3 

Slots for LAT 18-57 

SMB 
get current date and time 18-128 
overview 18-127 

Soft reset 14-12 

Software interrupts 
asynchronous communictaions 

15-70 

basic 15-132 
bootstrap 15-133 
cassette input/output 15-88 
disk input/output (i/o) 15-38 


keyboard break 15-141 
keyboard input 15-101 
print screen 15-4 

printer output 15-123 
read configuration 15-35 
return memory size 15-37 
revector of interrupt 13h 
RTC alarm 15-148 
time-of-day 15-135 

timer tick 15-141 

video input/output 15-8 


15-145 


Software triggered strobe 
three-channel counter and speaker 
6-6 
SORT 16-30 
Sort tables 16-32 
creating 16-30 
SORT. EXE 
how affected by FONT.COM 16-16 
Sorting 
format 16-30 
Special purpose register 7-23, 9-18 
Specify command 
diskette drive controller 
register sets 11-26 
Speed 
indicator control signal 9-17 


Square wave model 
three-channel counter and speaker 
mode 6-5 
Standard applications support 17-74 
temporarily suspending 17-79 
Standard communication of the 
VAXmate workstation 13-2 
Startup 
diagnostics 14-1, 14-8 
diagnostics test modes 14-1 
Status 
buffer for session 18-100 


for session 18-99 
Status register 4-14, 7-3, 10-9, 12-23 
A 7-37 
B 7-38 

keyboard-interface controller 8-6 
Status response 

three-channel counter and speaker 

6-14 


STDUS.KEY 16-25 
changing to 16-25 


Subroutines 
assembly language A-1 
Synchronous requests 18-89 
SYSREQ 17-5 
System 
bus 13-2, 13-40 
configuration list 
during extended self-test 14-10 
newly installed options 14-10 
powerup 8-4 
RAM powerup test checks 14-8 
register 6-9 
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Temporary register 4-14 
Terminal emulation 
font size 17-73 
Termination function 15-90 
Test 
drive ready function 15-54 
for character available 17-75 
reports for mouse self-test 10-3 
Text modes 7-6 
cursor rate 7-8 
cursor size 7-8 
ThinWire 
Ethernet 13-3 
interconnect 13-3 
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network interface 13-4 


Three-channel counter and speaker 
control word register 6-11 
counter and speaker example 6-20 
counter-latch command 6-12 
mode 0 6-4 
mode 1 6-4 
inode 2 6-5 
mode 3 6-5 
mode 4 6-6 
mode 5 6-7 
mode definitions 6-3 
modes of operation 6-3 
programming example 6-16 
read-back command 6-13 
status response 6-14 
system register 6-9 

Time-of-Day interrupt 15-135 

Timer tick interrupt 15-141 

Toggling keyboard mode 17-4 

Translate mode 
keyboard 8-2 

TranslateMessage 17-4 

Translating 
attribute data 7-18 
graphic color data 7-18 
the keyboard 15-121 

Transmit 
character function 15-73, 15-124 
for datalink 18-10, 18-23 
holding register and receive buffer 

10-8 
descriptor ring pointer 13-26 
TransmitCommChar 17-64 
Transport error codes 18-95 
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TTY write string function 15-28 
U 


UART (8250A) registers 9-2 


programming example 9-22 


Universal asynchronous receiver/ 
transmitters (8250A UART) 9-1 


User call-back routines for datalink 
18-8 


VAXmate 


address decode logic 13-5 

diagnostics 13-4 

expansion box 13-40 

I/O board 13-1 

1/O bus 13-5 

I/O functions 13-2 

memory option 13-40 

network software 18-1 

video display memory 13-40 

workstation 
base configuration 1-1 
optional components 1-2 

Verify 

one or more disk sectors function 
15-46 

one or more track sectors 15-65 


Video 


input/output interrupt 15-8, 15-9 
modes for the ROM BIOS 15-10 
parameters interrupt 15-142 


Video controller 

color select register 7-39 

control register A 7-41 

enhancements to industry-standard 
features 7-2 

industry-standard features 7-1 

programming example 7-45 

status register A 7-37 

status register B 7-38 

text modes 7-6 

unavailable industry-standard fea- 


tures 7-2 
video modes 7-5 
write data register 7-39 


Video memory 7-3 
Video modes 7-5 
handling inside a window 17-79 
no ROM BIOS 
DIGITAL-extended 7-12, 7-14 
ROM BIOS 
industry-standard 7-11, 7-13 
ROM BIOS 
DIGITAL-extended 7-15, 7-16, 
7-17 
Video processor 
input/output registers 7-22 
iook-up table 7-18 
Virtual protected mode 14-8 
VT220 
additional emulator escape se- 
quences C-6 
announcing C-8 
character set differences C-5 
communications differences C-3 
DA C-8 
DECAUPSS C-6 
DECRQUPSS C-6 
differences between emulator and 
terminal C-2 
keyboard differences C-4 
printing C-9 
SCS C-6, C-7 
video differences C-2 
VT240 
additional emulator escape se- 
quences C-13 
announcing C-16 
character set differences C-13 
communications differences C-12 
DA C-15, C-16 
DECAUPSS C-13 
DECRQUPSS C-14 
difference between emulator and 
terminal C-10 


keyboard differences C-12 
Printer to Host mode C-12 
SCS C-14, C-15 

video differences C-10 
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Windows 
keyboard extensions 17-5 
layer 17-2 
reserved keys 17-5 
Write 
all mask bits 4-11 
character and attribute at cursor 
position 15-20 
character at cursor position 15-21 
character using terminal emulation 
15-25 
long 15-51 
one or more track sectors 15-64 
one or more disk sectors 15-45 
pixel 15-23 
Write command 
keyboard-interface controller 8-10 
Write data command 
diskette drive controller register 
sets 11-21 
Write data register 7-39 
Write deleted data command 
diskette drive controller register 
sets 11-22 
Write port 2 command 
keyboard-interface controller 8-13 
Write precompensation register 12-4 
sector command 12-15 
single mask bit 4-11 
status register command keyboard- 
interface controller 8-13 
WriteComm 17-63 
WriteLat 17-69 
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